マルチソースハブ

概要

Mutsumi は複数のソースからタスクを集約して一つの TUI に表示できます — グローバルな個人 TODO リストに加え、AI エージェントが管理する任意の数のプロジェクト mutsumi.json ファイルを統合します。

┌─────────────────────────────────────────────────────┐
│  [* メイン] [個人] [saas-app] [oshigrid]            │  ← ソースタブ
├─────────────────────────────────────────────────────┤
│  ┌─ saas-app ─────────────────────────────── 3/5 ─┐ │
│  │  ████████████░░░░░░░░  60%                      │ │  ← ダッシュボード
│  │  · 認証バグの修正                               │ │
│  │  · レートリミットの追加                         │ │
│  └─────────────────────────────────────────────────┘ │
│  ┌─ oshigrid ─────────────────────────────── 1/4 ─┐ │
│  │  ████░░░░░░░░░░░░░░░░  25%                      │ │
│  │  · カードレイアウトの更新                       │ │
│  │  · 画像読み込みの最適化                         │ │
│  └─────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────┤
│  8 件のタスク · 4 件完了 · 4 件未完了               │
└─────────────────────────────────────────────────────┘

アーキテクチャ

~/.mutsumi/
├── config.toml           # グローバル設定 + [[projects]] レジストリ
└── mutsumi.json          # 個人タスク（グローバル TODO）

~/projects/saas-app/
└── mutsumi.json          # プロジェクトタスク（Agent が書き込み）

~/projects/oshigrid/
└── mutsumi.json          # プロジェクトタスク（Agent が書き込み）

各ソースは独立して動作します — それぞれの mutsumi.json ファイル、それぞれのファイルウォッチャー。TUI がそれらを統合ビューに集約します。

セットアップ

1. 個人タスクの初期化

mutsumi init --personal

~/.mutsumi/mutsumi.json にグローバル個人タスクファイルを作成します。

2. プロジェクトの登録

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

各プロジェクトの mutsumi.json が TUI のソースとして追加されます。

3. 起動

mutsumi

Mutsumi は登録済みのすべてのソースを自動検出し、タブとして表示します。

タブレイアウト

シングルソースモード

プロジェクトが登録されていない場合、クラシックなスコープタブが表示されます：

[今日] [今週] [今月] [受信箱]

マルチソースモード

プロジェクトが登録されている場合、ヘッダーにソースタブが表示されます：

[* メイン] [個人] [saas-app] [oshigrid]

★ メイン — すべてのソースの進捗を表示する集約ダッシュボード
個人 — グローバル個人タスク (~/.mutsumi/mutsumi.json)
プロジェクトタブ — 登録プロジェクトごとに 1 つのタブ

スコープサブフィルター

特定のソースタブ（メイン以外）を表示中に、スコープフィルターが表示されます：

[今日] [今週] [今月] [受信箱] [すべて]

f を押してスコープを切り替えるか、フィルターボタンをクリックします。

プロジェクト管理 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"

設定のマイグレーション

古いバージョンからアップグレードする場合：

# tasks.json → mutsumi.json にマイグレーション（カレントディレクトリ）
mutsumi migrate

# 設定ディレクトリのマイグレーション（~/.config/mutsumi/ → ~/.mutsumi/）
mutsumi migrate --config

# すべてマイグレーション
mutsumi migrate --all

キーボードショートカット

キー	アクション
`1`–`9`	ソースタブにジャンプ（マルチソース）またはスコープタブ（シングルソース）
`f`	スコープフィルターを切り替え（今日 → 今週 → 今月 → 受信箱 → すべて）
`Enter`	ダッシュボードから選択中のソースを開く

後方互換性

ファイル命名: mutsumi.json が優先されますが、tasks.json が見つかった場合は自動フォールバック
シングルソース: プロジェクト未登録時は、クラシックなシングルファイルモードと同一の動作
設定: ~/.mutsumi/config.toml と ~/.config/mutsumi/config.toml の両方をサポート（新パスが優先）