マルチソースハブ
Mutsumi は複数のソースからタスクを集約して一つの TUI に表示できます — グローバルな個人 TODO リストに加え、AI エージェントが管理する任意の数のプロジェクト mutsumi.json ファイルを統合します。
┌─────────────────────────────────────────────────────┐│ [* メイン] [個人] [saas-app] [oshigrid] │ ← ソースタブ├─────────────────────────────────────────────────────┤│ ┌─ saas-app ─────────────────────────────── 3/5 ─┐ ││ │ ████████████░░░░░░░░ 60% │ │ ← ダッシュボード│ │ · 認証バグの修正 │ ││ │ · レートリミットの追加 │ ││ └─────────────────────────────────────────────────┘ ││ ┌─ oshigrid ─────────────────────────────── 1/4 ─┐ ││ │ ████░░░░░░░░░░░░░░░░ 25% │ ││ │ · カードレイアウトの更新 │ ││ │ · 画像読み込みの最適化 │ ││ └─────────────────────────────────────────────────┘ │├─────────────────────────────────────────────────────┤│ 8 件のタスク · 4 件完了 · 4 件未完了 │└─────────────────────────────────────────────────────┘アーキテクチャ
Section titled “アーキテクチャ”~/.mutsumi/├── config.toml # グローバル設定 + [[projects]] レジストリ└── mutsumi.json # 個人タスク(グローバル TODO)
~/projects/saas-app/└── mutsumi.json # プロジェクトタスク(Agent が書き込み)
~/projects/oshigrid/└── mutsumi.json # プロジェクトタスク(Agent が書き込み)各ソースは独立して動作します — それぞれの mutsumi.json ファイル、それぞれのファイルウォッチャー。TUI がそれらを統合ビューに集約します。
セットアップ
Section titled “セットアップ”1. 個人タスクの初期化
Section titled “1. 個人タスクの初期化”mutsumi init --personal~/.mutsumi/mutsumi.json にグローバル個人タスクファイルを作成します。
2. プロジェクトの登録
Section titled “2. プロジェクトの登録”mutsumi project add ~/projects/saas-appmutsumi project add ~/projects/oshigrid各プロジェクトの mutsumi.json が TUI のソースとして追加されます。
mutsumiMutsumi は登録済みのすべてのソースを自動検出し、タブとして表示します。
タブレイアウト
Section titled “タブレイアウト”シングルソースモード
Section titled “シングルソースモード”プロジェクトが登録されていない場合、クラシックなスコープタブが表示されます:
[今日] [今週] [今月] [受信箱]マルチソースモード
Section titled “マルチソースモード”プロジェクトが登録されている場合、ヘッダーにソースタブが表示されます:
[* メイン] [個人] [saas-app] [oshigrid]- ★ メイン — すべてのソースの進捗を表示する集約ダッシュボード
- 個人 — グローバル個人タスク (
~/.mutsumi/mutsumi.json) - プロジェクトタブ — 登録プロジェクトごとに 1 つのタブ
スコープサブフィルター
Section titled “スコープサブフィルター”特定のソースタブ(メイン以外)を表示中に、スコープフィルターが表示されます:
[今日] [今週] [今月] [受信箱] [すべて]f を押してスコープを切り替えるか、フィルターボタンをクリックします。
プロジェクト管理 CLI
Section titled “プロジェクト管理 CLI”# プロジェクトの登録mutsumi project add ~/projects/my-app
# 登録済みプロジェクトの一覧mutsumi project list
# プロジェクトの削除mutsumi project remove my-appプロジェクトは ~/.mutsumi/config.toml に保存されます:
[[projects]]name = "saas-app"path = "/Users/you/projects/saas-app"
[[projects]]name = "oshigrid"path = "/Users/you/projects/oshigrid"設定のマイグレーション
Section titled “設定のマイグレーション”古いバージョンからアップグレードする場合:
# tasks.json → mutsumi.json にマイグレーション(カレントディレクトリ)mutsumi migrate
# 設定ディレクトリのマイグレーション(~/.config/mutsumi/ → ~/.mutsumi/)mutsumi migrate --config
# すべてマイグレーションmutsumi migrate --allキーボードショートカット
Section titled “キーボードショートカット”| キー | アクション |
|---|---|
1–9 | ソースタブにジャンプ(マルチソース)またはスコープタブ(シングルソース) |
| f | スコープフィルターを切り替え(今日 → 今週 → 今月 → 受信箱 → すべて) |
| Enter | ダッシュボードから選択中のソースを開く |
- ファイル命名:
mutsumi.jsonが優先されますが、tasks.jsonが見つかった場合は自動フォールバック - シングルソース: プロジェクト未登録時は、クラシックなシングルファイルモードと同一の動作
- 設定:
~/.mutsumi/config.tomlと~/.config/mutsumi/config.tomlの両方をサポート(新パスが優先)