# Как дать агенту CLI вместо лишнего интерфейса

CLI-Anything помогает сделать приложение управляемым для AI: вместо тяжёлых кликов и экранов агент получает короткие команды, JSON-вывод и воспроизводимые тесты.

## Что это за инструмент

| Компонент | Зачем нужен | Ссылка |
| --- | --- | --- |
| **CLI-Anything** | Генерирует CLI-harness для приложения или репозитория: команды, REPL, JSON-вывод, тесты и документацию. | [github.com/HKUDS/CLI-Anything](https://github.com/HKUDS/CLI-Anything) |
| **CLI-Hub** | Каталог готовых командных обвязок, которые можно искать, ставить и запускать. | [clianything.cc](https://clianything.cc) |

## Установка

```
# Пакетный менеджер готовых CLI
pip install cli-anything-hub
cli-hub list
cli-hub search image
cli-hub install gimp

# Генератор CLI для Claude Code
/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
/cli-anything ./my-app
```

## Когда это особенно полезно

- [ ] У приложения много действий в интерфейсе, и агент тратит контекст на навигацию.
- [ ] Нужны повторяемые операции: импорт, экспорт, генерация, проверка, запуск пайплайна.
- [ ] Хочется получать структурированный JSON, а не длинный текст из UI.
- [ ] Нужно дать агенту доступ к программе без постоянного визуального управления.
- [ ] Команда хочет тестировать рабочие сценарии как обычные shell-команды.

## Как собрать CLI под свой проект

- [ ] Выдели 5-10 самых частых действий пользователя, которые агент должен делать без кликов.
- [ ] Передай CLI-Anything путь к локальному приложению или публичному репозиторию.
- [ ] Проверь, что команды имеют понятные имена: `add`, `list`, `export`, `validate`, `run`.
- [ ] Попроси JSON-режим для всех команд, где агенту нужно читать результат.
- [ ] Запусти generated tests и отдельно руками проверь один критичный сценарий.
- [ ] Добавь README с примерами, чтобы следующий агент не изучал проект с нуля.

## Промпт для агента

```
Сделай для этого проекта agent-friendly CLI.
Сначала найди основные пользовательские сценарии и внутренние API.
Спроектируй команды с короткими именами и JSON-выводом.
Реализуй CLI без лишних зависимостей, если можно.
Добавь тесты на основные команды и ошибки.
Проверь запуск локально.
В конце покажи: список команд, примеры запуска, путь к файлам и что осталось вне покрытия.
```

## Контроль качества

- [ ] Команда должна быть быстрее и дешевле, чем проход через браузер.
- [ ] Вывод должен быть машинно-читаемым: JSON, exit codes, короткие ошибки.
- [ ] Опасные операции должны требовать явного флага подтверждения.
- [ ] Тесты должны запускаться одной командой и покрывать минимум happy path и ошибки.
- [ ] Документация должна объяснять не философию, а реальные команды запуска.

---

Источник: https://localhost:3000/m/kak-dat-agentu-cli-vmesto-lishnego-interfeysa