cli — команда для Claude Code: справка CLI в CLAUDE.md
Команда для Claude Code проверяет наличие CLI-утилиты и добавляет её справку в CLAUDE.md, чтобы агент видел команды и параметры инструментов проекта.
MIT ★ 763 обновлён 2026-03-31
.claude/commands/cli.mdЧто делает cli
Перед запуском команда проверяет, доступна ли утилита, затем пробует получить справку через --help, -h или help. Вывод может идти в stderr: команда объединяет его с stdout, убирает ANSI-коды и сохраняет примеры команд и параметры.
Справка попадает в сворачиваемый блок раздела CLI Tools Reference в CLAUDE.md; новые утилиты добавляются по алфавиту. Если файла нет, раздел создаётся после Configuration. При очень длинном выводе команда оставляет только ключевые разделы, а если утилита не найдена, предлагает проверить установку и PATH.
Для установки в Claude Code сохраните файл команды по пути .claude/commands/cli.md. Если CLAUDE.md — символическая ссылка, команда обновляет целевой файл, вероятно AGENTS.md.
Какие задачи решает
- проверить, установлена ли CLI-утилита и доступна ли она через
PATH - сохранить справку
npm,gitилиcargoвCLAUDE.md - добавить сведения об утилите в алфавитном порядке
- сократить слишком длинную справку до ключевых разделов
Примеры запросов агенту
- Добавь справку для
npmвCLAUDE.md:/agents-md:cli npm. - Проверь, доступен ли
git, и сохрани его справку в проекте:/agents-md:cli git. - Добавь описание команд
cargoв справочный раздел:/agents-md:cli cargo.
Как установить cli
Вручную: положить файлы
.claude/commands/cli.mdВызов — /cli. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/cli.mdВызов — /prompts:cli. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/cli.prompt.mdВручную: положить файлы
.gemini/commands/cli.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о cli
Как установить cli в Claude Code?
Сохраните файл команды как .claude/commands/cli.md.
Что делает cli?
Проверяет доступность CLI-утилиты, получает её справку и добавляет её в раздел CLI Tools Reference файла CLAUDE.md.
Что произойдёт, если справка слишком длинная?
Команда захватит только ключевые разделы, если вывод превышает 500 строк.
Исходный текст
cli.md · MIT
--- description: Capture CLI tool help documentation and add it to CLAUDE.md for AI assistant reference category: claude-setup allowed-tools: Bash(*:--help), Bash(*:-h), Bash(*:help), Bash(which:*), Bash(echo:*), Bash(sed:*), Edit, Read argument-hint: "<cli-tool-name>" --- # Add CLI Tool Documentation to CLAUDE.md Capture help documentation from CLI tools and add it to CLAUDE.md for future reference. ## Usage `/agents-md:cli <tool-name>` Examples: - `/agents-md:cli npm` - `/agents-md:cli git` - `/agents-md:cli cargo` ## Task ### 1. Check Tool Availability First, verify the CLI tool exists: !`which $ARGUMENTS 2>/dev/null && echo "✅ $ARGUMENTS is available" || echo "❌ $ARGUMENTS not found"` ### 2. Capture Help Documentation If the tool exists, capture its help output. Try different help flags in order: ```bash # Try common help flags $ARGUMENTS --help 2>&1 || $ARGUMENTS -h 2>&1 || $ARGUMENTS help 2>&1 ``` ### 3. Update CLAUDE.md Add or update the CLI tool documentation in CLAUDE.md following these steps: 1. **Check for existing CLI Tools Reference section** - If it doesn't exist, create it after the Configuration section - If it exists, add the new tool in alphabetical order 2. **Format the documentation** as a collapsible section: ```markdown ## CLI Tools Reference Documentation for CLI tools used in this project. <details> <summary><strong>$ARGUMENTS</strong> - [Brief description from help output]</summary> ``` [Help output here, with ANSI codes stripped] ``` </details> ``` 3. **Clean the output**: - Remove ANSI escape codes (color codes, cursor movements) - Preserve the structure and formatting - Keep command examples and options intact 4. **Extract key information**: - Tool version if shown in help output - Primary purpose/description - Most commonly used commands or options ### 4. Provide Summary After updating CLAUDE.md, show: - ✅ Tool documentation added to CLAUDE.md - Location in file where it was added - Brief summary of what was captured - Suggest reviewing CLAUDE.md to ensure formatting is correct ## Error Handling - If tool not found: Suggest checking if it's installed and in PATH - If no help output: Try running the tool without arguments - If help output is extremely long (>500 lines): Capture key sections only - If CLAUDE.md is a symlink: Update the target file (likely AGENTS.md) ## Implementation Notes When processing help output: 1. Strip ANSI codes: `sed 's/\x1b\[[0-9;]*m//g'` 2. Handle tools that output to stderr by using `2>&1` 3. Preserve important formatting like tables and lists 4. Keep code examples and command syntax intact
© carlrannaberg · MIT · carlrannaberg/claudekit