跳转到内容
Mutsumi

快速上手

Switch to normal mode

5 分钟入门

Section titled “5 分钟入门”

  1. 安装 Mutsumi

    Terminal window
    uv tool install git+https://github.com/ywh555hhh/Mutsumi.git

  2. 进入你的项目目录

    Terminal window
    cd ~/your-project

  3. 创建任务

    Terminal window
    mutsumi add "修复登录 Bug" --priority high --scope day --tags "bugfix"
    mutsumi add "写周报" --priority normal --scope week --tags "life"
    mutsumi add "更新文档" --priority low --scope month --tags "docs"

    验证：

    Terminal window
    mutsumi list
    # 应显示 3 个任务

  4. 启动 TUI

    Terminal window
    mutsumi

    你应该看到类似这样的界面：

    [Today] Week  Month  Inbox              mutsumi
    ─────────────────────────────────────────────────
    v HIGH ─────────────────────────────────────
    [ ] 修复登录 Bug                  bugfix  ***
    

    v NORMAL ───────────────────────────────────
    [ ] 写周报                        life    **
    

    v LOW ──────────────────────────────────────
    [ ] 更新文档                      docs    *
    

    ─────────────────────────────────────────────────
    3 tasks · 0 done · 3 pending

  5. 试试基本操作

    按键操作
    ↑ / ↓上下移动光标
    Space切换任务完成状态
    n创建新任务
    Enter展开任务详情面板
    1 2 3 4切换 Today / Week / Month / Inbox 标签
    q退出

初始化配置（可选）

Section titled “初始化配置（可选）”
Terminal window
mutsumi init --defaults

这会在 ~/.mutsumi/config.toml 创建默认配置：

  • 主题：monochrome-zen
  • 快捷键：arrows
  • 语言：en

如需中文界面：

Terminal window
mutsumi init --lang zh

完全可以跳过这一步 —— Mutsumi 不需要任何配置文件即可工作。

监视指定文件

Section titled “监视指定文件”

默认监视当前目录的 mutsumi.json。你也可以指定路径：

Terminal window
mutsumi --path /path/to/mutsumi.json

下一步

Section titled “下一步”