// Crater CLI 共享基础：安全调用 crater 命令的通用规则，包括可执行文件选择、全局选项、--json、--no-interactive、--help、错误输出、退出码、敏感信息处理，以及执行会修改用户环境的命令前的确认规则。处理任何 Crater CLI 操作前使用。
| name | crater-cli-shared |
| version | 1.0.1 |
| description | Crater CLI 共享基础：安全调用 crater 命令的通用规则，包括可执行文件选择、全局选项、--json、--no-interactive、--help、错误输出、退出码、敏感信息处理，以及执行会修改用户环境的命令前的确认规则。处理任何 Crater CLI 操作前使用。 |
| metadata | {"requires":{"bins":["crater"]}} |
通过 crater 命令帮助用户操作 Crater 平台时，先遵守本共享规则。
CRITICAL — 处理任何 Crater CLI 操作前，先读取本文件。
crater；如果用户说明正在本地开发、测试或验证刚编译出的 CLI，则优先调用工作区内的二进制，例如从仓库根目录使用 ./cli/crater，从 cli/ 目录使用 ./crater。<command> --help 查看当前帮助。--json，从 stdout 解析成功数据。常用全局行为见 references/crater-cli-global-flags.md。
错误分类、退出码与 HTTP 错误码约定见 references/crater-cli-error-handling.md。
--yes / -y 来跳过确认；只有用户明确同意跳过确认或明确要求非交互执行时才使用。Crater CLI 认证域：指导 AI Agent 帮用户登录、重新登录、查看和切换已保存身份、删除凭据、登出当前身份，以及排查 token、session、active_context、Keyring、401/403、未登录等认证问题。用户提到 crater auth、login、logout、switch、ls、rm、session、token、active context、Keyring、未登录、认证失败、权限错误时使用。
Crater CLI 补全域：指导 AI Agent 帮用户生成、安装、更新或卸载 bash/zsh Tab 补全脚本，并排查 shell 补全不可用问题。用户提到 crater completion、crater comp、Tab 补全、bash、zsh、.bashrc、.zshrc、补全脚本、completion install/uninstall 时使用。
Crater CLI 配置域：指导 AI Agent 帮用户查看和修改 CLI 本地配置，当前重点支持显示语言切换。用户提到 crater config、language、语言、中文、英文、切换语言、显示语言、配置项、state.json 时使用。