命令行界面
Mutsumi 提供完整的 CLI 接口，基于 click 框架构建。CLI 可用于脚本、Agent 集成或不想打开 TUI 时的快速操作。
启动 TUI
Section titled “启动 TUI”# 监视当前目录的 mutsumi.jsonmutsumi
# 指定文件路径mutsumi --path ./project/mutsumi.json
# 查看版本mutsumi --version任务 CRUD
Section titled “任务 CRUD”# 添加任务mutsumi add "修复登录 Bug" --priority high --scope day --tags "bugfix"mutsumi add "写周报" -P normal -s week -t "life"mutsumi add "重构模块" -d "需要重写整个 auth 层"
# 列出任务mutsumi listmutsumi list --scope today
# 标记完成mutsumi done <id-prefix>
# 编辑任务mutsumi edit <id-prefix> --title "新标题" --priority low --scope week
# 删除任务mutsumi rm <id-prefix>初始化与设置
Section titled “初始化与设置”# 交互式初始化mutsumi init
# 使用默认值初始化mutsumi init --defaults
# 指定语言mutsumi init --lang zh
# Agent 集成设置mutsumi setup --agent claude-code # 注入到 CLAUDE.mdmutsumi setup --agent codex-cli # 注入到 AGENTS.mdmutsumi setup --agent gemini-cli # 注入到 GEMINI.mdmutsumi setup --agent custom # 打印到 stdoutmutsumi setup # 列出可用 Agent迁移与项目管理
Section titled “迁移与项目管理”# 迁移 tasks.json → mutsumi.json（当前目录）mutsumi migrate
# 迁移配置目录mutsumi migrate --config
# 注册项目源mutsumi project add ~/projects/my-app
# 列出注册的项目mutsumi project list
# 移除项目mutsumi project remove my-app# 打开编辑器编辑mutsumi config --edit
# 打印当前配置mutsumi config --show
# 重置为默认值mutsumi config --reset
# 打印配置文件路径mutsumi config --path# 校验 mutsumi.json 格式mutsumi validate
# 输出 JSON Schemamutsumi schema
# 以 Markdown 格式输出字段说明mutsumi schema --format markdown命令参数速查
Section titled “命令参数速查”mutsumi add
Section titled “mutsumi add”| 参数 | 缩写 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
title | — | 位置参数 | (必填) | 任务标题 |
--priority | -P | high/normal/low | normal | 优先级 |
--scope | -s | day/week/month/inbox | inbox | 时间范围 |
--tags | -t | 逗号分隔 | "" | 标签 |
--description | -d | string | "" | 描述 |
mutsumi edit
Section titled “mutsumi edit”| 参数 | 类型 | 说明 |
|---|---|---|
id | 位置参数 | 任务 ID（前缀匹配） |
--title | string | 新标题 |
--priority | high/normal/low | 新优先级 |
--scope | day/week/month/inbox | 新 scope |
--tags | 逗号分隔 | 新标签 |
| 退出码 | 含义 |
|---|---|
0 | 成功 |
1 | 一般错误 |
2 | 文件未找到 |
3 | JSON 校验失败 |