Todori

日本語

English

日本語

English

Appearance

インストール ​

前提条件 ​

  • Node.js 18以降（npx用）
  • Claude Code CLIまたはMCP対応のClaude Desktop

Claude MCPを使用したインストール ​

Todoriをインストールする最も簡単な方法は、Claude MCPコマンドを使用することです：

bash
claude mcp add todori -- npx -y @litols/todori

このコマンドにより：

  1. Claude設定にMCPサーバーとして構成されます
  2. すべてのClaude Codeセッションで使用可能になります
  3. 必要時に自動的に最新版がダウンロードされます

Claude Code Pluginを使用したインストール ​

スラッシュコマンドも含めてTodoriをClaude Code Pluginとしてインストールすることもできます：

bash
# GitHubからプラグインをインストール
claude plugin add https://github.com/litols/todori

インストール後、Claude Codeを再起動してスラッシュコマンドを使用：

/todori-tasks       # すべてのタスクを表示
/todori-next        # 推奨される次のタスクを取得（表示のみ）
/todori-claim       # 次のタスクをこのセッションに割り当て（割当 + 開始）
/todori-release     # 割り当てられたタスクを解放
/todori-add         # 新しいタスクを追加
/todori-done        # タスクを完了としてマーク
/todori-status      # マルチセッションのタスク概要を表示
/todori-init        # プロジェクトでTodoriを初期化

nextとclaimの違い: /todori-nextは推奨タスクを表示するだけですが、/todori-claimはさらにそのタスクをセッションに割り当て、ステータスを「in-progress」に設定します。ccmanagerを使ったマルチエージェントワークフローではclaimを使用してください。

手動インストール ​

手動でインストールする場合、または開発版を使用したい場合：

1. リポジトリのクローン ​

bash
git clone https://github.com/litols/todori.git
cd todori

2. 依存関係のインストール ​

bash
bun install

3. プロジェクトのビルド ​

bash
bun run build:dist

4. MCPサーバーの設定 ​

Claude設定ファイルにTodoriを追加：

Claude Desktop (macOS)の場合：

~/Library/Application Support/Claude/claude_desktop_config.jsonを編集：

json
{
  "mcpServers": {
    "todori": {
      "command": "npx",
      "args": ["-y", "@litols/todori"]
    }
  }
}

Claude Code CLIの場合：

~/.config/claude/config.jsonを編集：

json
{
  "mcpServers": {
    "todori": {
      "command": "npx",
      "args": ["-y", "@litols/todori"]
    }
  }
}

開発版を使用する場合は、ローカルビルドを使用できます：

json
{
  "mcpServers": {
    "todori": {
      "command": "node",
      "args": ["/path/to/todori/dist/server/index.js"]
    }
  }
}

動作確認 ​

インストール後、Todoriが正しく動作しているか確認：

  1. 新しいClaude Codeセッションを開始
  2. MCPサーバーが自動的に接続されます
  3. タスクを作成してみる：
タスクを作成: ドキュメントを書く

タスクが正常に作成されれば、Todoriは正しく設定されています！

設定 ​

タスク保存場所 ​

デフォルトでは、Todoriはプロジェクトディレクトリの.todori/tasks.yamlにタスクを保存します。この場所は最初のタスク作成時に自動的に作成されます。

プロジェクト検出 ​

Todoriは以下を探すことでプロジェクトルートを自動検出します：

  • Gitリポジトリ（.gitディレクトリ）
  • パッケージマネージャーファイル（package.json、Cargo.toml、go.modなど）

MCP設定でプロジェクトルートを手動で指定することもできます：

json
{
  "mcpServers": {
    "todori": {
      "command": "npx",
      "args": ["-y", "@litols/todori"],
      "env": {
        "TODORI_PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

トラブルシューティング ​

MCPサーバーが接続しない ​

  1. Node.jsがインストールされているか確認: node --version
  2. npxが利用可能か確認: npx --version
  3. Claudeのログでエラーメッセージを確認

タスクが永続化されない ​

  1. プロジェクトディレクトリへの書き込み権限を確認
  2. .todori/ディレクトリが作成可能か確認
  3. 検出されたプロジェクトディレクトリ内にいるか確認

権限の問題 ​

Unix系システムでは、サーバースクリプトが実行可能であることを確認：

bash
chmod +x /path/to/todori/dist/server/index.js

次のステップ ​