⚡ RepoContext

AIコーディングエージェントとIDEのための次世代ASTコードベースマップ、トークン圧縮、コンテキストパッケージングエンジン。

English | 中文说明

🌟 RepoContextが必要な理由

コードベースを最新のAIコーディングアシスタント（Claude Code、Cursor、Windsurf、OpenAI Codex、Antigravity、Cline）に取り込む際、開発者は3つの重大なボトルネックに直面します：

1. 💥 トークンの爆発とAPIコストの高騰：生のコードダンプはすぐにコンテキスト制限を超えたり、1クエリあたり数十ドルのコストがかかったりします。

2. 📉 S/N比の低さ：行の80%は日常的な実装詳細です。LLMが必要とするのは意味論的なAPIサーフェス（シグネチャ、型、インターフェース、docstring）だけです。

3. 🔓 セキュリティリーク：.envの認証情報、APIキー、データベースURIがプロンプトに誤って露出する可能性があります。

RepoContextは、インテリジェントなASTアウトラインプルーニング、タスクに焦点を当てたセマンティックファイルランキング、自動認証情報の編集、ネイティブな**Model Context Protocol (MCP)**統合により、これら3つすべてを解決します。

Related MCP server: AtlasMemory

🚀 主な機能

• ⚡ ASTコードベースマップ＆スケルトナイザー：ソースファイルを**70%〜85%**圧縮し、インターフェース、型、関数、JSDoc/docstringを100%保持します。

• 🎯 タスク指向の関連性プルーニング：プロンプトクエリ（例：repocontext pack -q "Fix JWT auth token expiry"）を渡すと、最も重要なファイルだけを自動的にランク付けしてパックします。

• 🛡️ 自動シークレットスキャナー＆編集：組み込みのエントロピーと正規表現スキャナーがOpenAIキー、GitHubトークン、AWSキー、JWT、データベースURIを検出してマスクします。

• 🔌 ネイティブModel Context Protocol (MCP)サーバー：標準のMCPツールを介してClaude Desktop、Cursor、Windsurf、Antigravityと直接統合します。

• 📑 マルチフォーマットエクスポート：ディレクトリツリー付きのクリーンなMarkdown、Claude最適化XML（<documents>）、または構造化JSONを生成します。

• 📊 マルチモデルトークン＆コスト分析：GPT-4o、GPT-5、Claude 3.5 Sonnet、Gemini 1.5 Proのコスト見積もり付きリアルタイムトークンカウンター。

📦 クイックスタート

1. npxでインストールせずに実行

# Pack entire repository into an optimized Markdown prompt
npx repocontext pack

# Pack only files relevant to a specific task prompt
npx repocontext pack -q "Implement Stripe payment webhook handler" -o prompt.md

# Generate lightweight AST skeleton map (75%+ token reduction)
npx repocontext map -o codebase-map.md

2. グローバルインストール

npm install -g repocontext

🛠️ CLIの使用法とオプション

repocontext pack [dir] [options]

Options:
  -m, --mode <mode>         Packing mode: full | ast | relevant | hybrid (default: "full")
  -q, --query <query>       Filter and rank files relevant to a coding task prompt
  -f, --format <format>     Output format: markdown | xml | json (default: "markdown")
  -o, --output <file>       Output file path (default: "repocontext-output.md")
  -t, --max-tokens <number> Maximum token budget ceiling (default: 80000)
  --no-security             Disable secret scanning and auto-redaction
  -h, --help                Display help for command

🔌 Model Context Protocol (MCP)統合

RepoContextには組み込みのMCPサーバーサポートが含まれています。claude_desktop_config.jsonまたはCursor/WindsurfのMCP設定に追加してください：

{
  "mcpServers": {
    "repocontext": {
      "command": "npx",
      "args": ["-y", "repocontext", "mcp"]
    }
  }
}

公開されているMCPツール：

• get_codebase_map：リポジトリのASTシンボルアウトラインマップを返します。

• extract_relevant_context：コードベースをプルーニングし、プロンプトに必要なファイルのみを返します。

• read_file_outline：単一ファイルの圧縮されたASTスケルトンを読み取ります。

📊 ベンチマークと比較

🤝 貢献

貢献、問題、機能リクエストを歓迎します！issuesページをチェックしてください。

📄 ライセンス

このプロジェクトはMITライセンスです。