gitnexus-cli

GitNexus CLI コマンド

以下のコマンドでは node .gitnexus/run.cjs <command> を使用します。プロジェクトローカルのランナー gitnexus analyze は、インデックスの隣に配置されます。呼び出し時に利用可能なランナー（グローバルの gitnexus、それがなければ pnpm dlx、それもなければ npx）を自動的に選択するため、パッケージマネージャーを前提とせず、グローバルインストールも不要です。

まだ解析していない場合、または node .gitnexus/run.cjs で Cannot find module と表示される場合（Git で無視されるランナーが存在しない状態です。新規クローンや git clean の実行後など）プロジェクトのルートから npx gitnexus analyze を実行して再生成してください。npm 11.x でインストール中に npx がクラッシュする場合（node.target is null）、npm i -g gitnexus で一度インストールしてから gitnexus analyze を実行するか、pnpm --allow-build=@ladybugdb/core --allow-build=gitnexus --allow-build=tree-sitter dlx gitnexus@latest analyze を使用してください。詳しくは #1939 を参照してください。

コマンド

analyze — インデックスを構築または更新する

node .gitnexus/run.cjs analyze

プロジェクトのルートから実行します。すべてのソースファイルを解析し、ナレッジグラフを構築して .gitnexus/ に書き込み、コンテキストファイル CLAUDE.md / AGENTS.md を生成します。

フラグ	効果
--force	最新の状態でも、インデックスをすべて強制的に再作成します
--embeddings	セマンティック検索用の埋め込み生成を有効にします（デフォルトでは無効）
--drop-embeddings	再構築時に既存の埋め込みを削除します。デフォルトでは、--embeddings を指定せずに analyze を実行しても、埋め込みは保持されます。

実行するタイミング： プロジェクトで初めて使用するとき、大規模なコード変更の後、または gitnexus://repo/{name}/context でインデックスが古いと報告されたときです。Claude Code では、PostToolUse フックが git commit と git merge の後に古いインデックスを検出し、analyze を実行するようエージェントに通知します。このフック自体は analyze を実行しません。処理に最大 120 秒かかってエージェントをブロックしたり、タイムアウト時に KuzuDB が破損したりするのを防ぐためです。

status — インデックスの最新状態を確認する

node .gitnexus/run.cjs status

現在のリポジトリに GitNexus インデックスがあるか、最終更新日時、シンボルと関係の数を表示します。インデックスの再作成が必要か確認するときに使用します。

clean — インデックスを削除する

node .gitnexus/run.cjs clean

.gitnexus/ ディレクトリを削除し、グローバルレジストリからリポジトリの登録を解除します。インデックスが破損した場合や、プロジェクトから GitNexus を削除した後に、インデックスを再作成する前に使用します。

フラグ	効果
--force	確認プロンプトを省略します
--all	現在のリポジトリだけでなく、インデックス化されたすべてのリポジトリをクリーンアップします

wiki — グラフからドキュメントを生成する

node .gitnexus/run.cjs wiki

LLM を使用して、ナレッジグラフからリポジトリのドキュメントを生成します。API キーが必要です（初回使用時に ~/.gitnexus/config.json に保存されます）。

フラグ	効果
--force	すべて再生成します
--model <model>	LLM モデル（デフォルト：minimax/minimax-m2.5）
--base-url <url>	LLM API のベース URL
--api-key <key>	LLM API キー
--concurrency <n>	LLM 呼び出しの並列数（デフォルト：3）
--gist	wiki を公開 GitHub Gist として公開します

list — インデックス化されたすべてのリポジトリを表示する

node .gitnexus/run.cjs list

~/.gitnexus/registry.json に登録されているすべてのリポジトリを一覧表示します。MCP の list_repos ツールでも同じ情報を確認できます。

インデックス作成後

1. gitnexus://repo/{name}/context を読み取り、 インデックスが読み込まれたことを確認します
2. タスクに応じて、その他の GitNexus スキル（exploring、debugging、impact-analysis、refactoring）を使用します

トラブルシューティング

• 「Git リポジトリ内ではありません」：Git リポジトリ内のディレクトリから実行してください
• 再分析後もインデックスが古いまま：MCP サーバーを再読み込みするため、Claude Code を再起動してください
• 埋め込みの処理が遅い：--embeddings を省略する（デフォルトでは無効です）か、OPENAI_API_KEY を設定して、API ベースの埋め込みを高速化してください