mcpField
G
gitnexus-cli

gitnexus-cli

github.com/tony363開発2056 回インストール30 週間前に更新
リポジトリ

gitnexus-cli について

GitNexus CLIのコマンドをまとめたリファレンススキルです。リポジトリのインデックス作成、状態確認、削除、グラフからのドキュメント生成を扱い、インデックスを管理する開発者向けです。

主な機能

  1. 01リポジトリインデックスの作成・更新
  2. 02インデックスの鮮度確認
  3. 03インデックスと登録情報の削除
  4. 04グラフからドキュメントを生成
  5. 05インデックス済みリポジトリの一覧表示

活用シーン

  1. 01プロジェクトのインデックス作成
  2. 02再インデックスの要否を確認
  3. 03破損したインデックスの削除
  4. 04リポジトリドキュメントの生成

MCP 対応

GitNexus MCPを補完するCLIです。listコマンドでインデックス済みリポジトリを表示でき、MCPのlist_reposツールからも同じ情報を取得できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tony363/superclaude --skill gitnexus-cli

インストール後、Claude Code で/gitnexus-cliを入力して読み込まれたか確認します。

詳細

GitNexus CLI コマンド

すべてのコマンドは npx 経由で実行できるため、グローバルインストールは不要です。

コマンド

analyze — インデックスを作成または更新する
npx gitnexus analyze

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

フラグ効果
--force最新の状態でも、インデックスを強制的に再作成します
--embeddingsセマンティック検索用の埋め込み生成を有効にします（デフォルトでは無効）

実行するタイミング： プロジェクトで初めて実行するとき、大幅なコード変更の後、または gitnexus://repo/{name}/context でインデックスが古いと報告されたときです。Claude Code では、PostToolUse フックが git commit と git merge の後に analyze を自動実行し、以前に生成した埋め込みを保持します。

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

現在のリポジトリに GitNexus インデックスがあるか、最後に更新された日時、シンボル数と関係数を表示します。再インデックスが必要かどうかの確認に使います。

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

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

フラグ効果
--force確認プロンプトを省略します
--all現在のリポジトリだけでなく、インデックス済みの全リポジトリをクリーンアップします
wiki — グラフからドキュメントを生成する
npx gitnexus 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）
--gistWiki を公開 GitHub Gist として公開します
list — インデックス済みの全リポジトリを表示する
npx gitnexus list

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

インデックス作成後

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

トラブルシューティング

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

コメント

Markdown 対応