![\"](https://dev.to/\"https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Ffjonc08r7gndmqn3a4om.png\")
## 問題点
AI コーディングセッションは常に白紙から始まる。
Cursor や Claude Code を開くと、何かを尋ねる前に、有用な情報を得るために5分間、プロジェクトを再説明します。 同じスタック。 同じ目標。 同じ規約。 毎回。
私はこの問題を恒久的に解決するために ctxpilot を作りました。
それが何であるか
ctxpilot は、以下を行う CLI ツールおよび MCP サーバーです：
- AI を使ってコードベースをスキャンし、Living Context Document を作成する
- MCP を介して Cursor、 Claude Code、 Codex、 Windsurf にそのドキュメントを挿入する
- バックグラウンド・デーモンによって、 git コミットごとにドキュメントを自動更新する
私を納得させたデモ
新規 Codex セッション。プライベートな React Native プロジェクト。コンテキストは一切貼り付けず。
質問:「このプロジェクトは何で、私は何に取り組んでいるのか？」
Codex は正確なファイルパスと行番号を含む回答を返し、カート検証ロジックの特定のバグを特定しました — 最小数量が複数箇所でハードコードされ、cart.ts#L40 の Math.max(quantity, 6) によって黙って強制されていました。
その回答は LCD からのもので、Codex がファイルを探索した結果ではありませんでした。
3 つのコマンド
\\`bash
npm install -g @ctxpilot/ctxpilot
ctx init # コードベースをスキャンして LCD を生成
ctx setup # すべての AI クライアントを設定
ctx watch # 自動更新デーモンを開始
`\\
自動更新の仕組み
ctx watch は Chokidar を使って .git/refs/heads/ を監視するバックグラウンドデーモンを起動します。新しいコミットを検出すると、30 秒待ってから ctx update を実行します。
ctx update:
- 前回の更新以降の git の差分を読む
- 意思決定、完了した作業、新しいパターンなどのシグナルを抽出する
- Claude に新しいシグナルを取り入れた LCD の書き換えを依頼する
- 削除された内容をアーカイブする
- 更新された LCD を書き込む
結果として、すべてのセッションは新鮮なコンテキストから開始します。手動作業ゼロ。
ctx setup の仕組み
プロジェクト内で ctx setup を実行すると：
- ~/.claude/claude_desktop_config.json に MCP サーバー設定を書き込む
- ~/.codex/config.toml に MCP サーバー設定を書き込む
- ~/.cursor/mcp.json に MCP サーバー設定を書き込む
- ~/.windsurf/mcp.json に MCP サーバー設定を書き込む
- CLAUDE.md を作成し「LCD を最初に読む」指示を追加する
- .cursor/rules/ctxpilot.mdc を作成し alwaysApply: true を設定する
- .windsurf/rules/ctxpilot.md を作成する
- .agents を作成する
