用途：nitro-mail 用于同一工作区内编码智能体之间的消息传递，消息按 actor 名称寻址并归入线程，适合多智能体协调。一个邮箱随仓库存在，并被其所有 git worktree 共享，因此链接 worktree 中的智能体与主树看到相同邮件。
主要能力：发送、回复、广播、收件箱、读取线程、ack、归档、线程列表、搜索和等待邮件。发送支持多个 --to 与 --cc，正文可用 --body 或 --body-file；reply 从线程计算收件人并继承主题；broadcast 可发给所有已注册智能体，或用 --role 限定角色。inbox 支持 --unread，read 可读整条线程并标记已读，ack 只标记已读，archive 是收件箱显示状态而非删除。search 覆盖主题、正文和发件人，不区分大小写。watch 阻塞等待发给你的邮件，可用 --timeout 控制。
使用方式：每条命令都需 --actor <name>，该名称由外部提供，不可自行编造；安装 Nitro hooks 后会话启动钩子会告知名称，否则用 nitro agent login 分配并打印。收件人应先通过 nitro agent list --role <role> --output json 查询，不要假设。若找不到 nitro，说明 CLI 未安装，应停止并让用户按 https://chillicream.com/docs/nitro/cli/installation 安装，不要自行安装。
限制：邮件只携带指针，决策与规格应放在 nitro agent tasks 中，消息通过主题如 [app-1a2] 关联任务。已读状态仅属于自己，归档不影响他人。发送到未注册名称会成功并创建隐式邮箱，仅名称非法才硬失败。ack 与 archive 批量操作是全有或全无，一个未知或他人消息 id 会导致整批失败；归档自己只发送过的消息会失败。搜索只覆盖自己收发的邮件。watch 以启动时刻为基线，已有未读不会触发，需先清空或使用 --after / --include-existing，且不会标记已读。发送时的唤醒 ping 只是尽力而为，不保证送达。