tldr-cli — правило для Claude Code: анализ кода и установка
Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений.
MIT ★ 3 951 обновлён 2026-01-26
.claude/rules/tldr-cli.mdЧто делает tldr-cli
tldr-cli направляет агента к командам для изучения кодовой базы: tree показывает файлы, search ищет совпадения, а context собирает текст для задачи. Для анализа функций доступны графы потока управления и данных, срез программы и поиск вызывающих функций.
Правило также описывает проверку импортов, поиск мёртвого кода и архитектурных слоёв, а change-impact находит тесты, затронутые изменениями. Команды обычно выдают JSON; context возвращает текст для языковой модели. Для работы tldr должен быть доступен через PATH. Проверка diagnostics запускает pyright и ruff; заявлена поддержка Python, TypeScript, Go и Rust.
Какие задачи решает
- найти файлы и функции по структуре проекта
- проследить вызовы и импорты перед рефакторингом
- выявить неиспользуемый код и циклические зависимости
- определить тесты, затронутые изменёнными файлами
- проверить типы и стиль кода перед тестами
Примеры запросов агенту
- Покажи структуру проекта и найди функцию
process_dataвsrc/. - Проследи, какие функции вызывают
process_data, прежде чем менять её. - Найди тесты, затронутые изменениями в
src/foo.py, и проверь файл на ошибки типов.
Как установить tldr-cli
Вручную: положить файлы
.claude/rules/tldr-cli.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/tldr-cli.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/tldr-cli.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/tldr-cli.mdВручную: положить файлы
.clinerules/tldr-cli.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о tldr-cli
Как установить tldr-cli в Claude Code?
Добавь файл правила .claude/rules/tldr-cli.md в проект.
Что делает tldr-cli?
Это правило подсказывает агенту использовать CLI tldr для анализа структуры проекта, вызовов, импортов и последствий изменений. Оно также описывает поиск мёртвого кода и выбор тестов.
Что нужно для работы tldr-cli?
Команда tldr должна быть доступна через PATH. Команда diagnostics использует pyright и ruff.
Исходный текст
tldr-cli.md · MIT
# TLDR CLI - Code Analysis Tool You have `tldr` available on PATH for token-efficient code analysis. ## Commands ```bash # Core analysis tldr tree [path] # File tree tldr structure [path] --lang <lang> # Code structure (codemaps) tldr search <pattern> [path] # Search files tldr extract <file> # Full file info tldr context <entry> --project . # LLM-ready context # Flow analysis tldr cfg <file> <function> # Control flow graph tldr dfg <file> <function> # Data flow graph tldr slice <file> <func> <line> # Program slice tldr calls [path] # Cross-file call graph # Codebase analysis tldr impact <func> [path] # Who calls this function? (reverse call graph) tldr dead [path] # Find unreachable/dead code tldr arch [path] # Detect architectural layers # Import analysis tldr imports <file> # Parse imports from a file tldr importers <module> [path] # Find all files that import a module # Quality & testing (NEW) tldr diagnostics <file|path> # Type check + lint (pyright/ruff) tldr change-impact [files...] # Find tests affected by changes ``` ## When to Use - **Before reading files**: Run `tldr structure .` to see what exists - **Finding code**: Use `tldr search "pattern"` instead of grep for structured results - **Understanding functions**: Use `tldr cfg` for complexity, `tldr dfg` for data flow - **Debugging**: Use `tldr slice file.py func 42` to find what affects line 42 - **Context for tasks**: Use `tldr context entry_point` to get relevant code - **Impact analysis**: Use `tldr impact func_name` before refactoring to see what would break - **Dead code**: Use `tldr dead src/` to find unused functions for cleanup - **Architecture**: Use `tldr arch src/` to understand layer structure - **Import tracking**: Use `tldr imports file.py` to see what a file imports - **Reverse imports**: Use `tldr importers module_name src/` to find who imports a module - **Before tests**: Use `tldr diagnostics .` to catch type errors before running tests - **Selective testing**: Use `tldr change-impact` to run only affected tests ## Languages Supports: `python`, `typescript`, `go`, `rust` ## Example Workflow ```bash # 1. See project structure tldr tree src/ --ext .py # 2. Find relevant code tldr search "process_data" src/ # 3. Get context for a function tldr context process_data --project src/ --depth 2 # 4. Understand control flow tldr cfg src/processor.py process_data # 5. Before refactoring - check impact tldr impact process_data src/ --depth 3 # 6. Find dead code to clean up tldr dead src/ --entry main cli ``` ## Codebase Analysis Commands ### Impact Analysis ```bash tldr impact <function> [path] --depth N --file <filter> ``` Shows reverse call graph - all functions that call the target. Useful before refactoring. ### Dead Code Detection ```bash tldr dead [path] --entry <patterns> ``` Finds functions never called (excluding entry points like main, test_, etc.) ### Architecture Detection ```bash tldr arch [path] ``` Analyzes call patterns to detect: - Entry layer (controllers/handlers) - Middle layer (services) - Leaf layer (utilities) - Circular dependencies ### Import Analysis ```bash tldr imports <file> [--lang python] ``` Parses all import statements from a file. Returns JSON with module names, imported names, aliases. ### Reverse Import Lookup ```bash tldr importers <module> [path] [--lang python] ``` Finds all files that import a given module. Complements `tldr impact` which tracks function *calls* - this tracks *imports*. ### Diagnostics (Type Check + Lint) ```bash tldr diagnostics <file> # Single file tldr diagnostics . --project # Whole project tldr diagnostics src/ --format text # Human-readable output tldr diagnostics src/ --no-lint # Type check only ``` Runs pyright (types) + ruff (lint) and returns structured errors. Use before tests to catch type errors early. ### Change Impact (Selective Testing) ```bash tldr change-impact # Auto-detect (session/git) tldr change-impact src/foo.py # Explicit files tldr change-impact --session # Session-modified files tldr change-impact --git # Git diff files tldr change-impact --run # Actually run affected tests ``` Finds which tests to run based on changed code. Uses call graph + import analysis. ## Output All commands output JSON (except `context` which outputs LLM-ready text, `diagnostics --format text` for human output).
© parcadei · MIT · parcadei/Continuous-Claude-v3