magents 是一个面向编程智能体的共享会话总线，由 MCP 服务器和一个小型 CLI 组成。它针对的问题是：当用户同时运行多个编程智能体时，上下文往往被困在另一个窗口中，需要人工复述或粘贴。magents 直接读取各智能体已经保存在磁盘上的对话记录，提供统一 API，让智能体之间可以接续工作、互相发消息或启动独立会话。
主要能力
- 无需新开线程的交接：在一个智能体（如 Claude）中处理某分支后，切换到另一个智能体（如 Grok），后者可以读取前者的实时会话并继续，无需粘贴上下文。
- 非本人发送消息：当某个智能体遇到由另一个智能体负责的障碍时，可以直接向那个活跃线程注入消息并继续，适合发送方已掌握失败查询、文件和约束的场景。
- 启动独立工作：当任务可以独立进行时，可以启动新的无头持久化会话，提供完整提示词、在文件可能冲突时使用隔离工作目录，并要求通过 magents 回复。被启动的智能体保留其宿主原生的审批策略，启动不会增加审批绕过。
使用方式 安装：支持 Homebrew（macOS / Linux）、APT（Debian / Ubuntu），或从 Releases 下载对应平台二进制（magents-x86_64-unknown-linux-musl、magents-aarch64-unknown-linux-musl、magents-aarch64-apple-darwin、magents-x86_64-apple-darwin）。 宿主插件：插件包包含 magents 技能以及运行 magents mcp 的 MCP 条目。需先安装 CLI（brew install abnegate/tap/magents），再加载 plugins/ 下对应文件夹。Gemini CLI 可直接从仓库安装扩展；AGY CLI 从 plugins/agy 安装插件。 注册 MCP：magents install --all 会向每个已安装宿主注册 stdio MCP 服务器，跳过所需二进制不可用的宿主，包括 Grok、Claude Code、Codex、Cursor、OpenCode、Gemini CLI、GitHub Copilot CLI、AGY CLI。它还会在支持的宿主技能目录下写入 magents 和 learn 技能；/learn 会读取所有本地智能体的会话，不限于 Grok。 手动配置：Grok 和 Codex 可自行指向二进制；Cline 可在 MCP Servers → Configure MCP Servers 中向 cline_mcp_settings.json 添加配置。重启智能体会话或刷新 /mcps 后工具出现。 引用前缀：支持 claude:、grok:、codex:、cursor:、opencode:、gemini:、agy:、copilot: 等前缀。任何命令加 --output json 可获得稳定的机器可读输出。无参数且在管道 stdin 下运行 magents 会启动 MCP 服务器。magents spawn 默认从 stdin 读取完整任务（支持 --prompt-file），提示词文本不会作为进程参数。
会话通信机制 list_sessions / read_transcript / search_transcripts / search_memories 用于交接；create_memory 可写入另一个工具链（Claude、Codex 或 Grok）的第一方记忆。写入路径按工作应发生的位置选择：spawn_session 用于新的、无头、持久化、独立会话，成功仅表示启动被接受（accepted: true，status: "starting"），不代表任务完成；send_message 用于已有会话，始终记录邮箱邮件，并在宿主支持时注入实时用户轮次；handoff 将当前会话压缩到已有活跃会话中，使其继续同一工作。
交付路由 send_message 始终追加到邮箱，然后优先使用原生实时路径，否则启动受监督的无头恢复。受监督路由通过 stdin 传递用户轮次，不会在响应中暴露转录文本、令牌或原始宿主输出。spawn 从不添加审批绕过（如 --dangerously-skip-permissions、--yolo、--full-auto 等）。
会话发现来源 Claude 的 ~/.claude 和 ~/.claude-（以及 Desktop Claude / Claude- 会话目录）、Grok 的 ~/.grok/active_sessions.json、Codex 的 sqlite + rollout JSONL、Cursor 的 agent-transcripts、OpenCode 的 SQLite（opencode.db 及 channel 数据库，v1 session 与 v2 session_v2 / session_message 表）、Gemini journals、AGY CLI 的 conversations / brain 加 Antigravity 桌面 conversation_summaries、Copilot 的 session-state。Claude 会话在来自命名 home 时包含 profile 字段（如 work 对应 ~/.claude-work），恢复和实时注入使用该 home 的 CLAUDE_CONFIG_DIR。
适用场景与限制 适用于同时使用多个编程智能体、需要跨会话交接上下文、向指定活跃会话发消息或启动独立持久化任务的开发者。限制包括：需要 macOS 或 Linux（Claude UDS 注入仅限 Unix）；spawn 成功仅表示启动被接受；不添加审批绕过；具体收费、价格、平台支持范围等资料暂未提供。
