⚡ RepoContext

Движок нового поколения для построения AST-карт кодовой базы, сжатия токенов и упаковки контекста для ИИ-агентов и IDE.

English | 中文说明

🌟 Зачем нужен RepoContext?

При передаче кодовых баз современным ИИ-ассистентам (Claude Code, Cursor, Windsurf, OpenAI Codex, Antigravity, Cline) разработчики сталкиваются с тремя критическими проблемами:

1. 💥 Взрывной рост токенов и высокие затраты на API: Сырые выгрузки кода быстро превышают лимиты контекста или стоят десятки долларов за запрос.

2. 📉 Низкое соотношение сигнала к шуму: 80% строк — это рутинные детали реализации. LLM нужна только семантическая поверхность API (сигнатуры, типы, интерфейсы, docstring).

3. 🔓 Утечки безопасности: Случайное раскрытие учетных данных из .env, ключей API и URI баз данных в промптах.

RepoContext решает все три проблемы с помощью интеллектуального сокращения AST-структуры, семантического ранжирования файлов по задаче, автоматического редактирования учетных данных и нативной интеграции с Model Context Protocol (MCP).

Related MCP server: AtlasMemory

🚀 Ключевые возможности

• ⚡ AST-карта и скелетонизатор кодовой базы: Сжимает исходные файлы на 70–85%, сохраняя 100% интерфейсов, типов, функций и JSDoc/docstring.

• 🎯 Сокращение по релевантности задаче: Передайте свой запрос (например, repocontext pack -q "Исправить истечение JWT-токена"), чтобы автоматически ранжировать и упаковывать только самые важные файлы.

• 🛡️ Автоматический поиск и редактирование секретов: Встроенный энтропийный и regex-сканер обнаруживает и маскирует ключи OpenAI, токены GitHub, ключи AWS, JWT и URI баз данных.

• 🔌 Встроенный сервер Model Context Protocol (MCP): Прямая интеграция с Claude Desktop, Cursor, Windsurf и Antigravity через стандартные MCP-инструменты.

• 📑 Многоформатный экспорт: Генерирует чистый 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 или в настройки MCP в Cursor/Windsurf:

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

Доступные MCP-инструменты:

• get_codebase_map: Возвращает карту AST-символов репозитория.

• extract_relevant_context: Сокращает кодовую базу и возвращает только файлы, необходимые для запроса.

• read_file_outline: Читает сжатый AST-скелет для одного файла.

📊 Бенчмарк и сравнение

🤝 Вклад в проект

Приветствуются вклады, вопросы и запросы новых функций! Загляните на страницу issues.

📄 Лицензия

Проект распространяется под лицензией MIT.