Skip to content

Quick Start

Switch to Zen Mode
  1. Install Mutsumi

    Terminal window
    uv tool install git+https://github.com/ywh555hhh/Mutsumi.git
  2. Create your first tasks

    Terminal window
    cd ~/your-project
    mutsumi add "Fix login bug" --priority high --scope day --tags "bugfix"
    mutsumi add "Write weekly report" --priority normal --scope week --tags "life"
    mutsumi add "Update docs" --priority low --scope month --tags "docs"
  3. Launch the TUI

    Terminal window
    mutsumi
  4. Navigate and interact

    KeyAction
    / Move up / down
    SpaceToggle done/pending
    nCreate new task
    eEdit task
    DeleteDelete task (confirm with y)
    EnterShow detail panel
    1 2 3 4Switch tabs
    /Search tasks
    qQuit
  5. Initialize config (optional)

    Terminal window
    mutsumi init --defaults
[Today] Week Month Inbox mutsumi
─────────────────────────────────────────────────
v HIGH ─────────────────────────────────────
[ ] Fix login bug bugfix ***
v NORMAL ───────────────────────────────────
[ ] Write weekly report life **
v LOW ──────────────────────────────────────
[ ] Update docs docs *
─────────────────────────────────────────────────
3 tasks · 0 done · 3 pending