命令
| 命令 | 描述 | 子命令 |
|---|---|---|
| codearts help | 查看命令帮助 | 无 |
| codearts completion | 生成Shell自动补全脚本 | 无 |
| codearts mcp | 管理MCP服务器 | 详细子命令请参考MCP命令 |
| codearts [project] | 启动指定项目的TUI开发环境，其中[project]是可选参数，表示目标项目名称 例如，执行以下命令，进入TUI开发模式并加载Test项目： codearts D:\Test | 无 |
| codearts run [message] | 非交互模式运行码道CLI，直接传入提示词。 例如，执行以下命令，读取当前目录下的文件： codearts run 读取文件 | codearts run命令支持的参数列表请参考表2 |
| codearts agent | 管理智能体 |
|
| codearts models [provider] | 列出可用模型
| 无 |
| codearts stats | 显示Token使用量和成本统计信息 | 执行如下命令，查看所有统计数据 codearts stats 其余子命令请查看表3 |
| codearts session | 管理会话 |
|
| codearts export [sessionID] | 以JSON格式打印出指定会话ID的数据。其中，执行codearts session list可查询sessionID
| 无 |
| codearts import <file> | 从本地JSON文件导入会话数据，<file>为必填参数 例如，执行如下命令，将把指定文件的数据导入，多一条sessionID数据 codearts import seesion.json 使用场景：生成这条sessionID数据后，您可以基于该ID继续会话 | 无 |
| codearts upgrade | 将码道CLI升级到最新版本 | 无 |
| codearts uninstall | 卸载码道CLI并删除所有相关文件 | 无 |
| codearts docs | 获取码道CLI的帮助文档链接 | 无 |
| codearts privacy | 查看码道CLI的隐私政策 | 无 |
| codearts debug | 调试与故障排查工具 | 涉及子命令请查看表7 |
| codearts version | 打印版本号 | 无 |
| codearts --print-logs | 将日志输出到stderr | 无 |
| codearts --log-level | 日志级别（DEBUG、INFO、WARN、ERROR） | 无 |
| 标志 | 描述 |
|---|---|
| codearts run --command | 运行命令，使用--command <命令>。例如，执行如下命令，完成初始化： codearts run --command init 例如，执行如下命令，可运行test命令 codearts run --command test |
| codearts run --continue | 继续上一个会话，可缩写为“-c” 例如，执行如下命令，继续上一个会话 codearts run --continue |
| codearts run --sessionID | 要继续的sessionID，可缩写为“-s” 例如，执行如下命令，对指定sessionID执行 |
| codearts run --fork | 继续时分叉会话 |
| codearts run --model | 要使用的模型，可缩写为“-m” |
| codearts run --agent | 要使用的代理 |
| codearts run --file | 附加到消息的文件，可缩写为“-f” |
| codearts run --format | 格式：default或json |
| codearts run --title | 会话标题 |
| codearts run --thinking | 显示思考块 |
| 命令 | 描述 |
|---|---|
| codearts stats --days | 显示最近N天的统计信息
|
| codearts stats --tools | 显示工具维度的统计数据 |
| codearts stats --models | 显示所有模型用量明细 |
| codearts stats --project | 显示项目的统计数据 进入需要查询的Git仓根目录下，右键选择“在终端中打开”，执行如下命令，查询当前项目的统计数据。 codearts stats --project 说明： 若目标代码仓无Git提交记录，系统会展示全部非Git仓项目数据。 |
| 标志 | 简写 | 描述 |
|---|---|---|
| --continue | -c | 进入TUI开发模式，继续上一个会话 例如，执行如下命令，即可进入“D:\Test”项目下，进入TUI开发模式继续对话。 codearts D:\Test -c |
| --session | -s | 要继续的sessionID。其中，sessionID通过执行“codearts session list”获取。 codearts D:\Test -s <sessionID> |
| --fork | - | 基于指定会话创建分叉会话。子命令如下：
|
| --model | -m | 要使用的模型 |
| --agent | - | 要使用的代理 |
| 标志 | 简写 | 描述 |
|---|---|---|
| --max-count | -n | 限制为最近N个会话 |
| --format | - | 输出格式：table或json |
| 标志 | 简写 | 描述 |
|---|---|---|
| --keep-config | -c | 保留配置文件 |
| --keep-data | -d | 保留会话数据 |
| --dry-run | - | 显示将被删除的内容 |
| --force | -f | 跳过确认提示 |
| 命令 | 描述 |
|---|---|
| codearts debug config | 含义：显示解析后的完整配置 用途：查看当前生效的所有配置（包括合并了默认值、环境变量后的最终状态），用于排查配置加载问题 |
| codearts debug rg | 含义：ripgrep（代码搜索）调试工具，涉及子命令请查看表8 用途：专门调试ripgrep相关的行为，比如搜索规则、忽略文件、路径匹配等问题 |
| codearts debug file | 含义：文件系统调试工具，涉及子命令请查看 用途：用于调试文件读取/写入、路径解析、权限、符号链接等文件相关的问题 |
| codearts debug scrap | 含义：列出所有已知项目 用途：主要用于调试，帮助开发者了解码道CLI当前识别的项目 |
| codearts debug skill | 含义：列出所有可用技能 用途：输出当前环境中加载的所有Skill，包括它们的名称、描述、位置及内容 |
| codearts debug agent <name> | 含义：查看指定智能体的配置详情，<name>是必填参数 用途：输出某个智能体（Agent）的完整配置，包括权限、工具、模型参数、提示词等，用于调试Agent行为异常 |
| codearts debug paths | 含义：显示全局路径信息 用途：输出核心目录路径，包括数据目录、配置目录、缓存目录或者状态目录，用于排查文件找不到、权限问题 |
| codearts debug wait | 含义：无限等待（用于调试），如需退出，按快捷键（Windows（Ctrl+C）/Mac（⌘+C）） 用途：启动后不退出，保持进程运行，方便调试器附加到进程中进行调试 |
| 命令 | 描述 |
|---|---|
| codearts debug rg tree | 含义：表示使用ripgrep展示文件目录树 用途：
典型场景：怀疑项目文件被意外忽略，想确认ripgrep的扫描范围 |
| codearts debug rg files | 含义：使用ripgrep列出所有文件 用途：
典型场景：某个文件在码道CLI里搜不到，想确认是否被ripgrep忽略 |
| codearts debug rg search <pattern> | 含义：使用 ripgrep 搜索文件内容 用途：
典型场景：搜索结果缺失、匹配规则异常，用原生 ripgrep 做对比验证 |
| 命令 | 描述 |
|---|---|
| codearts debug file read <path> | 含义：以JSON格式读取并输出指定文件的内容 用途：
|
| codearts debug file status | 含义：显示文件系统状态信息 用途：
|
| codearts debug file list <path> | 含义：列出当前项目下指定目录下的所有文件和子目录 用途：主要用于列举项目下的目录下的文件和子目录 |
| codearts debug file search <query> | 含义：按条件模糊搜索当前项目下的文件 用途：用于快速查找跟条件相似的文件 |
| codearts debug file tree [dir] | 含义：显示指定的目录下非空目录的树结构 用途：以树形视图展示指定目录的完整结构，直观查看目录层级 |
