Atom CLI

Atom CLI 是 Atom Agent 的 Node.js 终端入口。当前发布构建提供 Pi 原生 InteractiveMode、 非交互 exec 和模型认证命令。交互入口直接组合 Pi Model、Session、资源与 Runtime，并加载 Atom System Prompt、内置 Extension、Skill、Prompt 和 Theme。

npm install --global @jackietsien/atom

atom --provider chatgpt
atom --continue --provider chatgpt
atom --resume
atom --session <path-or-id> --thinking high
atom --models "openai-codex/*,anthropic/*" --tools read,bash,edit,write
atom --extension ./extension.ts --skill ./skills/review --theme ./theme.json
atom install <pi-package>
atom config
atom auth status chatgpt
atom doctor
atom doctor --session <session-id-or-path>
atom doctor --network

默认界面由锁定版本 Pi 直接提供流式输出、Thinking、Tool 参数与结果、多行和中文输入、Abort、 resize、Session、Model、Steering、Follow-up、队列、compaction、资源 reload 和 Project Trust。 Atom 不复制这些命令或交互。

Atom 内置 Extension 提供品牌 Header、状态和终端标题；atom-dark 与 atom-light 提供两套可选 主题。界面在宽、窄终端下都保持有界，并保留 Pi 原生 Editor、消息、Tool、错误和终端恢复行为。

所有 Pi 原生命令由 InteractiveMode 注册和执行，包括 Session、Model、Settings、认证、资源、 导入导出和 Package 相关能力。Atom 额外提供 /permissions、/exit、 /skill:atom-evidence-check、/atom-check 和 /atom-resources，不维护固定命令数量或命令镜像。 /exit 是 Pi 原生优雅退出流程的 Atom 别名；Pi 内置 /quit、Ctrl+D 和 Ctrl+C 仍然可用。

/trust 由 Pi 管理项目资源授权；选择信任后，项目 Extension 将继承 atom 进程权限。 /reload 由 Pi 重新加载设置、Package、资源、Extension、Tool 和 System Prompt。--resume 启动选择器使用 Pi 公开的 Session 组件，取消时不会创建新会话。

交互、--print、--mode 和 exec 的目标安全模型使用同一套权限边界：Ask for approval 是 默认 Workspace Sandbox，越界请求由用户决定；Auto approval 使用同一个 Sandbox，由受控 Reviewer 审查越界请求；Full access 直接使用 Host 权限。Read only 已删除，不保留 CLI 别名、兜底或兼容映射。CLI 使用 ask-for-approval、auto-approval 和 full-access 三个值。

文件、网络、Bash 和固定用途 Tool 必须使用统一的 Scope、Approval 与有界 Executor。人工批准可 绑定单次动作或当前 Session 的确切范围；自动批准只允许当前动作，不能创建 Session Grant。 非交互 Ask for approval 直接拒绝越界，Auto approval 只执行 Reviewer 明确批准的动作，失败 或需要人工决定时拒绝。exec 为 Tool 输出有界动作摘要、完成/失败和耗时；Provider error、aborted 或空响应必须非零退出。第一阶段不建设独立 Audit。

上述三档由 ADR 0018 定义。代码、 Linux 自动化 Sandbox、Auto Reviewer 与 Aggregate Approval 真实 PTY、固定性能基线及对抗性 Sandbox Eval 已完成；Reviewer 模型 Eval 仍待完成。macOS Sandbox 由 macOS 发布机本地强制验收， 不依赖 GitHub Actions。

atom doctor 显示 Atom 版本、安装包内的 Pi 版本和实际数据目录。它不会查找或复用系统中的 全局 Pi，因此可用于确认两套安装彼此独立。atom doctor --session 离线汇总指定 Session 的 Provider 错误、连续重试、Tool 失败、Transport 和请求体大小；atom doctor --network 只执行未 认证的 HTTPS 可达性探测，不调用模型或发送 Prompt。Provider Incident Journal 默认保存在 ~/.atom/diagnostics/runtime-incidents.jsonl，只包含脱敏元数据，写入失败不影响 Agent。