Справочник CLI

craft-cli — это терминальный клиент, который подключается к запущенному headless-серверу AIKraft Agents по протоколу WebSocket. Он предоставляет команды для просмотра ресурсов, управления сессиями, отправки сообщений с потоковой передачей в реальном времени и проверки состояния сервера.

Установка

# Клонирование репозитория
git clone https://github.com/anthropics/craft-agents.git
cd craft-agents

# Установка зависимостей
bun install

# Вариант A: Запуск напрямую
bun run apps/cli/src/index.ts <command>

# Вариант B: Глобальная установка (добавляет craft-cli в PATH)
cd apps/cli && bun link
craft-cli <command>

Быстрый старт

Самый быстрый способ попробовать — без настройки сервера:

# Самостоятельный запуск (автоматически запускает сервер)
ANTHROPIC_API_KEY=sk-... bun run apps/cli/src/index.ts run "Hello, world!"

Параметры подключения

Флаги переопределяют переменные окружения. Если --workspace не указан, используется первый доступный workspace автоматически.

Команды

Информация и проверка состояния

Просмотр ресурсов

Операции с сессиями

Отправка сообщения (с потоковой передачей)

craft-cli send <session-id> <message>
echo "Summarize this" | craft-cli send <session-id>

Команда send подписывается на session:event и потоково передаёт ответ ИИ в stdout в реальном времени:

Сырой RPC

craft-cli invoke <channel> [json-args...]   # Отправка любого RPC-канала
craft-cli listen <channel>                   # Подписка на push-события

invoke отправляет запрос на любой канал и выводит ответ. listen подписывается на push-канал и выводит события по мере поступления (Ctrl+C для остановки).

Run (самостоятельный запуск)

craft-cli run <prompt>
craft-cli run --workspace-dir ./project --source github "List open PRs"

Команда run полностью автономна — она запускает headless-сервер, создаёт сессию, отправляет запрос, потоково передаёт ответ и завершается. Не требуется отдельная настройка сервера. Ключ API определяется из --api-key, $LLM_API_KEY или переменной окружения конкретного провайдера (например, $ANTHROPIC_API_KEY, $OPENAI_API_KEY).

Настройка LLM:

# Примеры с несколькими провайдерами
craft-cli run --provider openai --model gpt-4o "Summarize this repo"
GOOGLE_API_KEY=... craft-cli run --provider google --model gemini-2.0-flash "Hello"
craft-cli run --provider anthropic --base-url https://openrouter.ai/api/v1 --api-key $OR_KEY "Hello"

Проверка сервера

# Против запущенного сервера
craft-cli --validate-server --url ws://127.0.0.1:9100 --token <token>

# Самостоятельный запуск (автоматически запускает сервер)
craft-cli --validate-server

Если --url не указан, --validate-server автоматически запускает локальный headless-сервер, выполняет проверку и завершает его работу.

Выполняет 21-этапный интеграционный тест, охватывающий полный жизненный цикл сервера, включая создание источников и скиллов:

1. Подключение + рукопожатие
2. credentials:healthCheck
3. system:versions
4. system:homeDir
5. workspaces:get
6. sessions:get
7. LLM_Connection:list
8. sources:get
9. sessions:create (временная сессия __cli-validate-*)
10. sessions:getMessages
11. Отправка сообщения + поток (текстовый ответ)
12. Отправка сообщения + использование инструмента (инструмент Bash)
13. sources:create (временный источник Cat Facts API)
14. Отправка + упоминание источника (использует созданный источник)
15. Отправка + создание скилла (запись SKILL.md через Bash)
16. skills:get (проверка появления скилла)
17. Отправка + упоминание скилла (вызов созданного скилла)
18. skills:delete (очистка)
19. sources:delete (очистка)
20. sessions:delete (очистка)
21. Отключение

Примечание: Этот тест изменяет состояние workspace — создаёт и удаляет временную сессию, источник и скилл. Все ресурсы очищаются по завершении. В случае ошибки продолжает выполнение и выводит сводку.

Используйте --json для машинно-читаемого вывода:

craft-cli --validate-server --json | jq '.results[] | select(.status == "FAIL")'

Устранение неполадок