斜杠命令
在 TUI 输入框中以 / 开头即可触发命令,并获得自动补全菜单。按功能分类的 30+ 个内置命令如下;Skills 和 Plugin 加载的命令也会自动出现在补全菜单里。
核心功能
| 命令 | 作用 |
|---|
/login | 推荐 — 一条命令完成 AtomGit OAuth + 申领 CodingPlan 免费额度 + 自动根据额度模型列表写好 provider 配置。首次启动最省事的入口;已登录后重跑会幂等地同步最新模型列表。v4.24.1 起 /codingplan 已折进 /login,旧入口已移除 |
/resume | 打开会话选择器,恢复任意一个之前的持久化会话(含消息、目录和模型状态) |
/session | 创建一个全新的、干净的会话 |
/bg | 将当前会话放到后台并打开新的前台会话;子命令: /bg list、/bg <N>、/bg drop <N>、/bg help。详见 后台会话 |
/background <task> | 兼容入口:在一个 /bg 槽位中启动一次性后台任务(详解) |
/rename <新名字> | 重命名当前会话(影响 /resume 选择器里的显示名) |
/provider | 打开 provider 管理界面,增删改切换 |
/model | 在当前 provider 下切换模型,或跨 provider 切换 |
/cd | 切换工作目录,并写回 default_workdir。也可以直接输入 cd /path(无需斜杠前缀) |
工具与实用操作
| 命令 | 作用 |
|---|
/undo | 回滚上一轮 AI 对本地文件的所有编辑,基于 file-history 快照 |
/diff | 显示当前工作目录未提交改动的 git diff |
/cost | 展示当前会话输出 token 数。不支持 usage 报告的 API 会自动估算 |
/context | 显示本轮上下文预算分解:系统提示、工具定义、冷区压缩、总消息数、context window 占用 |
/compact | 压缩历史消息,把早期对话压缩成摘要以腾出上下文预算 |
/clear | 清空当前会话的消息(保留工作目录和模型) |
/init | 扫描当前工作目录,生成 / 刷新 .atomcode.md 项目指令文件 — 内含 build / test 命令、技术栈摘要、目录结构等,后续每次启动都会作为系统提示注入 |
/background <任务> | 把任务派发给一个隔离的后台 agent(只读为主的工具子集),不污染当前主对话上下文。用于"顺手让它去查一下 X"这类轻探索。详见 后台会话 |
/worktree <子命令> | Git worktree 隔离:create 在新分支上拉一份独立 worktree、list 查看现有 worktree、done 把 worktree 改动 squash 回主分支、cleanup 清理已完成的 worktree |
/issue | 交互式向导:在当前 git 仓库对应的 AtomGit 仓库创建一个新 issue(需先 OAuth 登录,cwd 必须是 atomgit.com 仓库的 clone) |
对话模式与思考
| 命令 | 作用 |
|---|
/plan | 切到 Plan 模式:只读探索,模型可以调用 read_file / grep / list_directory 等不写盘的工具,但 edit_file / bash 等会被屏蔽。适合在动手之前让模型先理清方案 |
/build | 切回 Build 模式(默认):全部工具可用,可以读、写、执行。/plan 和 /build 之间可随时来回切 |
/think on / off | 开关 extended thinking(对支持的模型 — Claude / DeepSeek-R1 / GLM-4.5 等)。开启后模型会输出推理过程,代价是更慢更费 token |
/think budget <N> | 给 thinking 设个 token 预算上限(对 Claude 系列生效),控制推理长度 |
永久记忆
| 命令 | 作用 |
|---|
/remember <内容> | 记一条到项目级记忆(默认作用域,绑定当前工作目录) |
/remember --global <内容> | 记一条到全局记忆(所有项目共享) |
/forget <关键词> | 删除全局 + 项目记忆中含该关键词的所有条目(大小写不敏感) |
/memory | 查看当前生效的所有记忆,按 [Global] / [Project] 分组 |
详细使用与最佳实践见 永久记忆。
扩展生态
| 命令 | 作用 |
|---|
/setup | 第一次执行时,把内置的 atomcode-automation-recommender skill 解压到 ~/.atomcode/skills/,在项目 .gitignore 追加 .atomcode/local/,并写 .atomcode/setup-state.json(signals 哈希 + atomcode 版本 + 已安装列表),全程持项目级锁。然后自动调用 recommender skill — 它会扫描项目(语言、框架、已有 hook 等)、联网检索并推荐适合该代码库的其他 atomcode skill 安装。后续执行会跳过 seed 安装、直接重跑 skill。命令后跟的文字会作为 steering 传给 skill,例如 /setup 重点关注测试。CLI 形式 atomcode setup --force 会按内容哈希强制重装 seed 文件 |
/skills | 浏览当前已加载的 skills(项目级 + 用户级)。每个 skill 也会以独立的斜杠命令形式出现在补全菜单里,可以直接 /<skill-name> 触发 |
/plugin | 打开交互式插件管理器,可浏览 marketplace、安装/卸载插件、添加/移除 marketplace |
/plugin marketplace add|remove|update|list | 管理 marketplace 注册(add 克隆 git 仓库,remove 移除,update 拉最新,list 列出) |
/plugin install <plugin>@<marketplace> | 从指定 marketplace 安装插件 |
/plugin uninstall <plugin>@<marketplace> | 卸载已安装的插件(保留 marketplace 注册) |
/plugin list | 列出本地已安装的插件 |
/plugin reload | 重新加载所有插件(扫描磁盘变更、刷新 skill/hook 注册) |
详细配置与使用见 Skills 扩展 和 Plugin 系统。
MCP 集成
| 命令 | 作用 |
|---|
/mcp | 列出已成功连接的 MCP server 及其状态(连接失败的 server 不在此列表,只在会话区有红色错误行) |
/mcp tools <server> | 异步列出某个 MCP server 实际暴露的远端 tools(若超时/失败会提示) |
/mcp reload | 重新读取 .mcp.json / ~/.atomcode/mcp.json 并后台重连所有 server |
详细配置与使用见 MCP 集成。
WebUI 与同步
| 命令 | 作用 |
|---|
/webui | 启动浏览器界面并自动打开浏览器(默认绑定 127.0.0.1:13456,仅本机)。当前 TUI 会话会自动接入实时同步 |
/webui --host <addr> | 把服务绑定到指定地址;/webui lan 等价于 --host 0.0.0.0(暴露到局域网)。配合蒲公英虚拟 IP 可远程访问,见 远程访问指南 |
/webui stop | 关闭 webui 服务 |
/sync | 把当前 TUI 接入正在运行的 webui 会话(需先 /webui)。两端实时双向同步,多个浏览器 / 终端可同时围观同一会话 |
/sync off | 退出同步,回到独立会话 |
详细见 WebUI 界面。
配置与帮助
| 命令 | 作用 |
|---|
/status | 显示登录状态、当前 provider、模型、上下文预算、CodingPlan 用量和重置时间 |
/whoami | 显示当前 AtomGit 登录用户的用户名 / 邮箱 |
/config | 显示 ~/.atomcode/config.toml 的路径 |
/reload | 从磁盘热加载 ~/.atomcode/config.toml,不需要重启 atomcode 就能让外部修改(或另一个终端的 /login 带来的变更)生效 |
/language | 切换界面语言:自动检测(LC_ALL / LANG)、English、或 简体中文。立即生效并写回 ~/.atomcode/config.toml |
/welcome | 重新打开 3 步首次启动向导(欢迎页 → 语言 → 接入方式)。会话非空时会先弹 y/N 二次确认,确认后清屏。语言和默认接入方式都可以从这里再调一次 |
/logout | 清除 AtomGit OAuth token |
/upgrade | 自动升级到最新版本;子命令 /upgrade rollback 回滚到上一个版本 |
/guide | 内置上手向导:/guide 列出可问的主题(快速开始、换模型、MCP、Skills、记忆、后台任务、上下文、快捷键、配置),/guide <主题> 直接在对话里讲解(首次会自动安装 atomcode-skills 插件) |
/help | 展示所有可用斜杠命令的列表 |
/keys | 展示键盘快捷键参考(分组列出输入 / 历史 / 会话 / 弹层导航,并标注 Shift+Enter、Alt+Enter 在不同终端的兼容性)。详见 键盘快捷键 |
/quit | 退出 atomcode(也可以连按两次 Ctrl+C) |
命令使用技巧
- 自动补全 —— 输入
/ 后会立刻弹出补全菜单,用 ↑↓ 选择,Tab / Enter 确认。
- 模糊匹配 —— 补全支持子串匹配,比如输入
/prov 就能命中 /provider。
- 打断正在进行的操作 —— 模型正在流式输出时按
Esc 可以打断,然后再输入新的命令或 prompt。
- Skills 也会出现在菜单里 —— 当你在 Skills 目录中添加了自定义命令后,它们会以相同格式出现在补全菜单里。
典型工作流
第一次启动 — 一键接入
> /login
✔ Logged in as alice (alice, alice@example.com)
✔ CodingPlan claimed — CodingPlan Free · expires 2026-05-22 (29d / 30d)
✔ 3 models registered as AtomGit-* providers
✔ Default provider set to AtomGit-GLM
> 你好
做完一件事前把成本看一眼
> 重构 src/db 使用连接池
... (AI 执行)
> /cost
Session token usage
- Total output tokens: 8342
- Current turn tokens: 2156
- Context: 42K / 128K
改完不满意就回滚
> 给所有函数加 JSDoc
... (AI 编辑了 12 个文件)
> /undo
Rolled back 12 file edits from the last turn.
模型表现不好换一个再试
> /model
> (在弹出的菜单里选择 claude-opus-4-6)
> 再试一次,这次注意保留原有注释
下一步
- 快捷键 —— 命令和快捷键配合使用效率翻倍
- 会话与撤销 ——
/resume、/undo、/compact 的详细行为
