К основному содержанию
команда CX Codex

index-repo — команда для Claude Code: индекс репозитория

Команда index-repo анализирует структуру репозитория и создаёт PROJECT_INDEX.md и PROJECT_INDEX.json. Индекс помогает агенту изучать проект без чтения всех файлов при каждом запуске.

MIT ★ 23 950 обновлён 2026-09-27

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/index-repo.md
Открыть на GitHub

Что делает index-repo

Команда ищет файлы кода, документации, конфигурации, тестов и инструментов. Затем собирает сведения о точках входа, модулях, публичных функциях и классах, зависимостях и назначении конфигурационных файлов. Для анализа запускаются пять параллельных поисков по шаблонам файлов.

На выходе — PROJECT_INDEX.md для чтения человеком и PROJECT_INDEX.json для машинной обработки. В Markdown-индексе есть структура каталогов, точки входа, модули, документация, тесты и зависимости. Встроенная проверка ориентируется на размер индекса меньше 5 КБ, но это не гарантированный результат: большой проект может не уложиться в этот предел.

Для полного индекса запустите /index-repo; режим mode=quick пропускает тесты, а mode=update обновляет существующий индекс. В Claude Code команду устанавливают как .claude/commands/index-repo.md.

Какие задачи решает

  • собрать карту каталогов и файлов проекта
  • найти точки входа и основные модули
  • свести сведения о зависимостях и конфигурации
  • обновить индекс после изменений в репозитории
  • создать краткий индекс без анализа тестов

Примеры запросов агенту

  • Составь индекс текущего репозитория командой /index-repo.
  • Обнови существующий индекс проекта с помощью /index-repo mode=update.
  • Быстро проиндексируй проект, пропустив тесты: /index-repo mode=quick.

Как установить index-repo

Вручную: положить файлы

.claude/commands/index-repo.md

Вызов — /index-repo. Для всех проектов — ~/.claude/commands/

Вопросы об index-repo

Как установить index-repo в Claude Code?

Сохраните файл команды по пути .claude/commands/index-repo.md. После этого запустите /index-repo.

Что делает index-repo?

Анализирует файлы репозитория и создаёт PROJECT_INDEX.md и PROJECT_INDEX.json с описанием структуры, точек входа и ключевых частей проекта.

Чем режим mode=quick отличается от обычного запуска?

В режиме mode=quick команда пропускает анализ тестов.

Исходный текст

index-repo.md · MIT
---
name: sc:index-repo
description: Repository Indexing - 94% token reduction (58K → 3K)
---

# Repository Index Creator

📊 **Index Creator activated**

## Problem Statement

**Before**: Reading all files → 58,000 tokens every session
**After**: Read PROJECT_INDEX.md → 3,000 tokens (94% reduction)

## Index Creation Flow

### Phase 1: Analyze Repository Structure

**Parallel analysis** (5 concurrent Glob searches):

1. **Code Structure**
   ```
   src/**/*.{ts,py,js,tsx,jsx}
   lib/**/*.{ts,py,js}
   superclaude/**/*.py
   ```

2. **Documentation**
   ```
   docs/**/*.md
   *.md (root level)
   README*.md
   ```

3. **Configuration**
   ```
   *.toml
   *.yaml, *.yml
   *.json (exclude package-lock, node_modules)
   ```

4. **Tests**
   ```
   tests/**/*.{py,ts,js}
   **/*.test.{ts,py,js}
   **/*.spec.{ts,py,js}
   ```

5. **Scripts & Tools**
   ```
   scripts/**/*
   bin/**/*
   tools/**/*
   ```

### Phase 2: Extract Metadata

For each file category, extract:
- Entry points (main.py, index.ts, cli.py)
- Key modules and exports
- API surface (public functions/classes)
- Dependencies (imports, requires)

### Phase 3: Generate Index

Create `PROJECT_INDEX.md` with structure:

```markdown
# Project Index: {project_name}

Generated: {timestamp}

## 📁 Project Structure

{tree view of main directories}

## 🚀 Entry Points

- CLI: {path} - {description}
- API: {path} - {description}
- Tests: {path} - {description}

## 📦 Core Modules

### Module: {name}
- Path: {path}
- Exports: {list}
- Purpose: {1-line description}

## 🔧 Configuration

- {config_file}: {purpose}

## 📚 Documentation

- {doc_file}: {topic}

## 🧪 Test Coverage

- Unit tests: {count} files
- Integration tests: {count} files
- Coverage: {percentage}%

## 🔗 Key Dependencies

- {dependency}: {version} - {purpose}

## 📝 Quick Start

1. {setup step}
2. {run step}
3. {test step}
```

### Phase 4: Validation

Quality checks:
- [ ] All entry points identified?
- [ ] Core modules documented?
- [ ] Index size < 5KB?
- [ ] Human-readable format?

---

## Usage

**Create index**:
```
/index-repo
```

**Update existing index**:
```
/index-repo mode=update
```

**Quick index (skip tests)**:
```
/index-repo mode=quick
```

---

## Token Efficiency

**ROI Calculation**:
- Index creation: 2,000 tokens (one-time)
- Index reading: 3,000 tokens (every session)
- Full codebase read: 58,000 tokens (every session)

**Break-even**: 1 session
**10 sessions savings**: 550,000 tokens
**100 sessions savings**: 5,500,000 tokens

---

## Output Format

Creates two files:
1. `PROJECT_INDEX.md` (3KB, human-readable)
2. `PROJECT_INDEX.json` (10KB, machine-readable)

---

**Index Creator is now active.** Run to analyze current repository.

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
repo-skillopt objectivlabs Скилл repo-skillopt для Claude Code разбирает устройство репозитория и собирает спецификацию с опорой на файлы, конфиги и тесты. Активируется при просьбах объяснить кодовую базу, описать архитектуру, внести изменения или оценить риски. CX Codex +1 598установок audit-repo-docs FlorianBruniaux Команда audit-repo-docs проверяет документацию репозитория по 30 критериям и выдаёт отчёт с оценкой и списком улучшений. Пригодится, чтобы найти пробелы в README, структуре docs и автоматизации. CX Codex +1 ★ 6 529звёзд репо repo-standardizer официальный github Скилл repo-standardizer для GitHub Copilot приводит в порядок настройки GitHub-репозитория: шаблоны, метки, CI и документацию. Запускается по просьбе подготовить новый репозиторий или привести в порядок существующий. CX Codex +1 33установок index-sync FlorianBruniaux Правило index-sync напоминает обновлять машинный индекс, когда меняется guide/, и проверять ссылки на страницы. Пригодится в проекте, где индекс питает MCP-сервер и поиск. CX Codex +1 ★ 6 529звёзд репо auto-repo-setup daymade Скилл auto-repo-setup проверяет окружение репозитория, чинит настройку и защищает Git-операции. Пригодится перед работой, онбордингом или изменением хуков. CX Codex +1 534установок ctx-index mksglu Скилл ctx-index индексирует файлы проекта в локальную базу FTS5 для context-mode. Это избавляет ассистента от повторного чтения сырых файлов при поиске фрагментов. CX Codex +1 1 200установок

Из того же набора56

Весь набор →
devops-architect Субагент devops-architect автоматизирует инфраструктуру и пайплайны CI/CD. Помогает подготовить конфигурации для деплоя без простоя и настроить мониторинг. CX Codex ★ 23 950звёзд репо system-architect Субагент system-architect для Claude Code анализирует архитектуру системы, границы компонентов и решения для роста. Сравнивает паттерны и планирует миграции. CX Codex ★ 23 950звёзд репо sc Команда /sc запускает все функции фреймворка SuperClaude: поиск, анализ репозитория, специализированных агентов и рекомендации прямо из Claude Code. CX Codex +1 ★ 23 950звёзд репо performance-engineer Субагент performance-engineer находит узкие места в коде и ускоряет веб-приложения на основе реальных замеров. Пригодится при просадках Core Web Vitals, долгих ответах API или перерасходе памяти. CX Codex ★ 23 950звёзд репо agent Слэш-команда /sc:agent управляет ходом сессии: проверяет статус проекта при старте, планирует исследование и координирует вспомогательные скиллы для уверенной реализации. CX Codex +1 ★ 23 950звёзд репо quality-engineer Субагент quality-engineer проектирует тест-планы и находит граничные случаи и сценарии отказа, которые не видны по основному сценарию работы. CX Codex ★ 23 950звёзд репо technical-writer Субагент technical-writer пишет техническую документацию: API-референсы, гайды, спецификации и инструкции по установке с примерами кода и проверкой доступности. CX Codex ★ 23 950звёзд репо refactoring-expert Субагент refactoring-expert снижает цикломатическую сложность кода и устраняет технический долг через принципы SOLID. Пригодится при безопасном рефакторинге без изменения поведения системы. CX Codex ★ 23 950звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой