Repo Explorer

読み取り専用ツールを備えたClaude Code CLIプロセス(claude -p --model haiku)を別途起動して、リポジトリを探索し、そのリポジトリに関する質問に答えます。ローカルリポジトリとリモートURLの両方に対応しています。

ワークフロー

1. リポジトリソースと質問を特定する

ユーザーのメッセージから以下を抽出します:

• source: 以下のいずれか:
  • ローカルパス (~/projects/foo、/opt/services/bar、.または省略 = 現在のディレクトリ)
  • リモートURL (https://github.com/owner/repo、git@github.com:owner/repo.git)
  • 短縮形 (owner/repo — https://github.com/owner/repoとして扱う)
• question: リポジトリについて何を知りたいのか。

2. リモートリポジトリの場合 — テンポラリディレクトリにクローン

ソースがリモートURLまたは短縮形の場合、まずクローンします:

REPO_DIR=$(mktemp -d) && git clone --depth 1 <url> "$REPO_DIR" && echo "$REPO_DIR"

• 速度向上のため--depth 1を使用(シャロークローン、最新コミットのみ)
• ユーザーが特定のブランチ/タグについて問い合わせている場合: git clone --depth 1 --branch <ref> <url> "$REPO_DIR"
• 後でクリーンアップするため$REPO_DIRを保存します

3. CLIコマンドを実行

timeout: 600000(10分)を指定してBashツールを使用します。大規模なリポジトリの探索には数分かかる場合があります。

cd <repo_path> && CLAUDECODE= claude -p "<question>" \
  --model haiku \
  --output-format text \
  --max-turns 15 \
  --allowedTools "Read" "Grep" "Glob" "Bash(find *)" "Bash(ls *)" "Bash(wc *)" "Bash(git log *)" "Bash(git show *)" "Bash(git diff *)" "Bash(git branch *)" "Bash(head *)" "Bash(tail *)" \
  --append-system-prompt "You are a code exploration expert. Thoroughly explore the repository to answer the user's question. Strategy: 1) Glob to discover project structure. 2) Grep to find patterns, definitions, routes, classes. 3) Read to examine key files. Always cite file paths and line numbers. Give a structured answer based on code facts."

重要: CLAUDECODE=プレフィックス(環境変数を空に設定)は、Claude Codeをサブプロセスとして起動するために必須です。これがないと、ネストされたセッションがブロックされます。

ルール:

• 常にclaude -pの直前にCLAUDECODE=を含める(&&はなし、インライン環境変数オーバーライド)
• 質問内のダブルクォートを\"でエスケープ
• スペースを含むリポジトリパスはクォートで囲む
• 非常に大規模なリポジトリの場合、--max-turnsを25に増やす
• ユーザーが明示的にsonetまたはopusをリクエストしている場合、--model haikuに置き換える

4. クリーンアップ(リモートリポジトリのみ)

結果をユーザーに表示した後、テンポラリディレクトリを削除します:

rm -rf "$REPO_DIR"

5. 結果を表示

CLIの出力をユーザーに表示します。出力が空またはエラーの場合は、問題を報告し、より具体的な質問で再試行することを提案します。

例

ローカルリポジトリ:

cd ~/projects/my-api && CLAUDECODE= claude -p "What REST endpoints are defined? List each with HTTP method, path, and handler." --model haiku --output-format text --max-turns 15 --allowedTools "Read" "Grep" "Glob" "Bash(find *)" "Bash(ls *)" "Bash(wc *)" "Bash(git log *)" "Bash(git show *)" "Bash(git diff *)" "Bash(git branch *)" "Bash(head *)" "Bash(tail *)" --append-system-prompt "You are a code exploration expert. Thoroughly explore the repository to answer the user's question. Strategy: 1) Glob to discover project structure. 2) Grep to find patterns, definitions, routes, classes. 3) Read to examine key files. Always cite file paths and line numbers. Give a structured answer based on code facts."

リモートリポジトリ(GitHub URL):

REPO_DIR=$(mktemp -d) && git clone --depth 1 https://github.com/expressjs/express "$REPO_DIR"

その後:

cd "$REPO_DIR" && CLAUDECODE= claude -p "How is routing implemented? Describe the Router class and middleware chain." --model haiku --output-format text --max-turns 15 --allowedTools "Read" "Grep" "Glob" "Bash(find *)" "Bash(ls *)" "Bash(wc *)" "Bash(git log *)" "Bash(git show *)" "Bash(git diff *)" "Bash(git branch *)" "Bash(head *)" "Bash(tail *)" --append-system-prompt "You are a code exploration expert. Thoroughly explore the repository to answer the user's question. Strategy: 1) Glob to discover project structure. 2) Grep to find patterns, definitions, routes, classes. 3) Read to examine key files. Always cite file paths and line numbers. Give a structured answer based on code facts."

その後: rm -rf "$REPO_DIR"

短縮形(owner/repo): vercel/next.jsをhttps://github.com/vercel/next.jsとして扱います。

現在のディレクトリ(パスなし): cdなしでclaude -pを実行します。