CLI コマンドリファレンス

mutsumi（TUI 起動）

Mutsumi TUI タスクボードを起動します。

mutsumi [オプション] [サブコマンド]

オプション	短縮	説明	デフォルト
`--path PATH`	`-p`	タスクファイルのパス	`./mutsumi.json`（フォールバック：`./tasks.json`）
`--watch PATH`	`-w`	追加で監視するタスクファイルパス（繰り返し可能）	—
`--version`		バージョンを表示して終了	—
`--help`		ヘルプを表示して終了	—

使用例

# TUI を起動（カレントディレクトリの mutsumi.json を監視）
mutsumi

# 特定のファイルを監視
mutsumi --path /path/to/mutsumi.json

# 複数ファイルを同時監視（マルチプロジェクト）
mutsumi --path ~/proj-a/mutsumi.json -w ~/proj-b/mutsumi.json

# バージョンを表示
mutsumi --version

初回起動時、オンボーディングウィザードが自動的に実行されます。詳しくは起動フローを参照してください。

mutsumi add

新しいタスクを作成し、mutsumi.json に追加します。

mutsumi add タイトル [オプション]

オプション	短縮	タイプ	値	デフォルト
`--priority`	`-P`	選択	`high`, `normal`, `low`	`normal`
`--scope`	`-s`	選択	`day`, `week`, `month`, `inbox`	設定の `default_scope`
`--tags`	`-t`	文字列	カンマ区切り	`[]`
`--description`	`-d`	文字列	フリーテキスト	—

使用例

# 最小限
mutsumi add "ログインバグを修正"

# フルオプション
mutsumi add "ログインバグを修正" -P high -s day -t "bugfix,urgent" -d "リフレッシュ時にセッション切れ"

# 短縮フラグ
mutsumi add "テスト作成" -P low -s week -t "dev"

ユニーク ID と created_at タイムスタンプが自動生成されます。

mutsumi list

mutsumi.json のタスクを一覧表示します。

mutsumi list [オプション]

オプション	短縮	タイプ	値	デフォルト
`--scope`	`-s`	選択	`day`, `week`, `month`, `inbox`	すべて
`--done / --no-done`		フラグ		すべて表示

使用例

# すべてのタスクを表示
mutsumi list

# scope でフィルター
mutsumi list --scope day

# 未完了のみ
mutsumi list --no-done

# 完了済みのみ
mutsumi list --done

mutsumi done

タスクを完了にします（ID プレフィックスマッチング対応）。

mutsumi done TASK_ID

引数	説明
`TASK_ID`	完全なタスク ID またはユニークなプレフィックス

使用例

# 完全な ID
mutsumi done 01JQ8X7K3M0000000000000001

# プレフィックスマッチング
mutsumi done 01JQ

# プレフィックスが曖昧な場合、一致するタスクを列挙
mutsumi done 01
# エラー：'01' に一致するタスクが複数あります。より長いプレフィックスを指定してください。

status を "done" に設定し、completed_at を自動入力します。

mutsumi edit

既存タスクのフィールドを編集します（ID プレフィックスマッチング対応）。

mutsumi edit TASK_ID [オプション]

オプション	短縮	タイプ	値	説明
`--title`		文字列		新しいタイトル
`--priority`	`-P`	選択	`high`, `normal`, `low`	新しい優先度
`--scope`	`-s`	選択	`day`, `week`, `month`, `inbox`	新しい scope
`--tags`	`-t`	文字列	カンマ区切り	タグを置換
`--description`	`-d`	文字列	フリーテキスト	新しい説明

使用例

# タイトル変更
mutsumi edit 01JQ --title "新しいタイトル"

# 優先度と scope を変更
mutsumi edit 01JQ -P low -s week

# タグを置換
mutsumi edit 01JQ -t "docs,review"

# 説明を更新
mutsumi edit 01JQ -d "要件変更"

mutsumi rm

タスクを削除します（ID プレフィックスマッチング対応）。

mutsumi rm TASK_ID

引数	説明
`TASK_ID`	完全なタスク ID またはユニークなプレフィックス

使用例

mutsumi rm 01JQ

タスクとそのすべての子タスクを削除します。

mutsumi init

テンプレート mutsumi.json を生成します。

mutsumi init [オプション]

オプション	説明
`--force`	既存ファイルを上書き
`--personal`	個人タスクファイルを初期化（`~/.mutsumi/mutsumi.json`）
`--project`	カレントディレクトリに `mutsumi.json` を作成し、プロジェクトソースとして登録

使用例

# カレントディレクトリに mutsumi.json を作成
mutsumi init

# 既存ファイルを上書き
mutsumi init --force

# 個人タスクを初期化
mutsumi init --personal

# 作成してプロジェクトとして登録
mutsumi init --project

mutsumi setup

AI Agent の統合を設定します。Agent Skills をシンボリックリンクで Agent のスキルディレクトリにインストールします。

mutsumi setup [オプション]

オプション	短縮	タイプ	値	デフォルト
`--agent`	`-a`	選択	`claude-code`, `codex-cli`, `opencode`, `gemini-cli`, `aider`, `custom`	—
`--mode`		選択	`skills`, `skills+project-doc`, `snippet`	`skills`

モード説明

モード	動作
`skills`	5 つの Mutsumi スキルファイル（`mutsumi-manage`、`mutsumi-track`、`mutsumi-plan`、`mutsumi-report`、`mutsumi-context`）を `~/.mutsumi/skills/` からシンボリックリンクで Agent のスキルディレクトリにインストール。
`skills+project-doc`	スキルをインストールし、`## Mutsumi Task Integration` セクションを Agent のプロジェクトドキュメント（`CLAUDE.md`、`AGENTS.md` など）に追記。
`snippet`	統合プロンプトを標準出力に表示。ファイルのインストールなし。

インストールされるスキル

スキル	用途	自動トリガー？
`mutsumi-manage`	タスク CRUD（追加、編集、完了、削除）	いいえ — ユーザーの依頼時
`mutsumi-track`	作業中にタスク進捗を自動更新	はい
`mutsumi-plan`	目標をサブタスクに分解	いいえ — ユーザーの依頼時
`mutsumi-report`	ステータスサマリーを生成	いいえ — ユーザーの依頼時
`mutsumi-context`	セッション開始時にタスクボードのコンテキストを読み込み	はい

スキルディレクトリ

Agent	ディレクトリ
Claude Code	`~/.claude/skills/`
Codex CLI	`~/.agents/skills/`
Gemini CLI	`~/.gemini/skills/`
OpenCode	`~/.config/opencode/skills/`

使用例

# 利用可能な Agent とモードを表示
mutsumi setup

# Claude Code にスキルをインストール（デフォルトモード）
mutsumi setup --agent claude-code

# スキルをインストール + CLAUDE.md にプロジェクトドキュメントを注入
mutsumi setup --agent claude-code --mode skills+project-doc

# 手動使用のためにプロンプトを表示（Aider、カスタム Agent）
mutsumi setup --agent custom --mode snippet

# 他の Agent にもスキルをインストール
mutsumi setup --agent gemini-cli
mutsumi setup --agent codex-cli
mutsumi setup --agent opencode

再実行しても安全です — 古いシンボリックリンクを置き換え、重複インストールは発生しません。

mutsumi migrate

レガシーファイル名と設定場所からの移行を行います。

mutsumi migrate [オプション]

オプション	説明
（なし）	カレントディレクトリで `tasks.json` → `mutsumi.json` にリネーム
`--config`	設定ディレクトリを移行（`~/.config/mutsumi/` → `~/.mutsumi/`）
`--all`	タスクファイルと設定の両方を移行

使用例

# tasks.json → mutsumi.json に移行
mutsumi migrate

# 設定ディレクトリを移行
mutsumi migrate --config

# すべて移行
mutsumi migrate --all

mutsumi project

登録済みプロジェクトソースを管理します。

mutsumi project add

mutsumi project add PATH

プロジェクトディレクトリをソースとして登録します。ディレクトリには mutsumi.json が含まれている（または含まれる予定の）必要があります。

mutsumi project add .
mutsumi project add ~/projects/saas-app

mutsumi project remove

mutsumi project remove NAME

プロジェクトの登録を解除します。

mutsumi project remove saas-app

mutsumi project list

mutsumi project list

登録済みのすべてのプロジェクトとそのパスを一覧表示します。

mutsumi validate

タスクファイルのスキーマを検証します。

mutsumi validate

mutsumi.json（または --path で指定したファイル）を検証します。必須フィールドの欠落、無効な enum 値、不正な JSON を報告します。

使用例

# デフォルトファイルを検証
mutsumi validate

# 特定のファイルを検証
mutsumi -p /path/to/mutsumi.json validate

mutsumi schema

mutsumi.json の JSON Schema を出力します。

mutsumi schema

使用例

# ターミナルに表示
mutsumi schema

# ファイルに出力
mutsumi schema > schema.json

ID プレフィックスマッチング

TASK_ID 引数を取るコマンド（done、edit、rm）はプレフィックスマッチングに対応しています。完全な ID を入力する必要はありません：

mutsumi done 01EX    # "01EX" で始まる ID が1つだけならマッチ

プレフィックスが曖昧な場合、Mutsumi は一致するタスクを列挙し、より長いプレフィックスの入力を求めます。

終了コード

コード	意味
`0`	成功
`1`	一般エラー（ファイル未検出、ID 曖昧など）
`2`	引数無効