Working with Agents

Aster 支持 Claude Code、Codex、OpenCode、Cursor CLI、Kimi Code、Pi、omp 和 Grok Build。在“设置 → 智能体”中，每个 provider 会显示图标与检测到的 CLI 绝对路径；从 Finder 或 Dock 启动 Aster 时，也会识别 ~/.local/bin、Homebrew 及常见 Node 版本管理器里的安装。右侧“已安装 / 关闭”和开关专指 Aster 受管 lifecycle 集成，与 CLI 路径是独立状态；展开一行后可另行控制它是否出现在快速启动入口，并为 wrapper、环境配置或自定义可执行文件设置结构化启动命令。安装和卸载只改动带 Aster 标识的 hook/plugin；用户自己的配置保持不变，变更后应重启对应 Agent。Grok Build 的用户级 hook 写在 ~/.claude/settings.json（Grok 把它当 Claude 兼容层读取），与 Claude Code 的 Aster 条目并排、互不覆盖；两边的 hook 会先确认调用方再上报状态，避免把 Grok 标签标成 Claude。Grok 首次在某个项目跑 hook 时可能要 /hooks-trust。Grok 会话暂时不会出现在 Agent 历史浮层或 Open Quickly。

• lifecycle hook 把 processing / idle / awaiting-input 归一到所属 PTY，驱动标签徽章、完成/等待通知和“处理期间阻止睡眠”。不会读取或保存 prompt 正文。
• “Shell”菜单对齐 Otty 的完整结构：顶部是“重命名标签页…”“设置标签页前缀…”（共用同一原生对话框，后者预选动态前缀模式）与“清屏”（⌘K）；随后是围绕当前工作目录的“拷贝路径”“在访达中显示”“打开方式”（无可靠 CWD 时置灰）；中段保留 Vi/Mark/Hint、只读模式与 Composer；底部是“Git”子菜单（图形客户端入口 + Commit/Push/Pull/Fetch/Merge…/Rebase…，全部只预填命令到终端，由你回车执行）与“通知与权限…”（跳到设置的 Shell 分类）。“打开方式”与“Git”和窗口标题胶囊弹层显示完全相同的条目。
• 打开“Shell”菜单时，Aster 会根据当前聚焦 Pane 显示 Codex、Claude 等对应的 Agent 子菜单；切换分屏后菜单随焦点更新，不会操作同一标签里的其它 Agent。菜单展开后，Fork 动作会固定作用于当时的工作区，不会因设置页或其它窗口切换到前台而失效或落到别处。在“设置 → 智能体”安装对应 lifecycle 集成并重启 Agent 后，会话会自动关联，可拷贝会话 ID、查看会话历史，或 Fork 到上下左右分屏、新标签页、新窗口。Agent 子菜单的“查看会话历史”只显示当前项目的会话（优先按已关联会话的项目归属判定，尚未关联时按该 Pane 的工作目录）；要浏览全部项目的历史，请使用命令面板（⇧⌘P）里的“Agent 历史”。Codex 首次加载新 hook 时还需运行 /hooks 审核并信任 Aster 条目；安装器会迁移旧版 Aster 遗留的非法顶层 hooks 布尔配置。尚未收到可信会话 ID 时，复制与 Fork 会保持禁用。
• Agent 历史浮层（Agent 子菜单“查看会话历史”按当前项目打开；命令面板“Agent 历史”显示全部）与 Open Quickly 可搜索已知 provider 的本机会话记录，并使用 provider 原生命令 Resume 或 Fork；不支持 Fork 的 provider 会明确拒绝。在 Agent 历史里按 ↩ 或点“打开”，会像 Otty 一样把该会话作为新标签打开：左侧 TABS 增加一项（标签名即会话标题），右侧只读渲染完整 transcript：你的消息显示为浅色卡片、Agent 回复按 Markdown 渲染，连续的工具调用折叠成一行摘要（如「Claude · 30×Bash, 26×Edit」，点击展开）；页头显示标题、会话文件与项目归属，并提供 Resume / Fork。超长会话按单条与总量上限截断并明确标注；同一会话重复打开只会选中已有标签。
• Composer 支持多行草稿、普通文件附件、固定/浮动与取消；发送时使用 bracketed paste，仍服从只读和粘贴保护。Prompt Queue 只按 lifecycle hook 的 idle 自动派发，processing 与 awaiting-input 都只排队；未安装 hook 时不自动发送，每一项都由你点击左侧发送图标提交。
• Send to Chat 可接收终端选区、当前可见 transcript 或文件上下文。上下文被包在 untrusted-context 中，移除终端控制字符、遮盖常见密钥并执行 128 KiB 总预算；Aster 不声称能识别所有业务敏感信息，发送前仍应复核。终端发送面板会以普通键入预填目标 Agent 输入框，最终提交始终由你决定。