Справочник CLI-команд
Краткий обзор всех команд верхнего уровня CLI Предиктор Икс. Для полной справки используйте `predictorx <command> --help`.
CLI Предиктор Икс позволяет выполнять практически все действия, доступные в веб-интерфейсе (создание задач, назначение агентов, запуск демона и многое другое). На этой странице перечислены все команды верхнего уровня с кратким описанием. Полный список флагов и примеров можно посмотреть, выполнив predictorx <command> --help.
Аутентификация
При первом использовании CLI выполните эту команду, чтобы получить персональный токен доступа (PAT):
predictorx loginВаш браузер откроется автоматически. После подтверждения в веб-приложении CLI сохранит PAT (с префиксом prdx_) в файле ~/.predictorx/config.json. Все последующие команды будут использовать этот токен для аутентификации.
Для CI или headless-сред пропустите браузерный процесс: создайте PAT в веб-приложении в разделе Settings → Personal Access Tokens, а затем выполните predictorx login --token <prdx_...>, чтобы передать его напрямую.
Различия между типами токенов описаны в разделе Аутентификация и токены.
Аутентификация и настройка
| Команда | Назначение |
|---|---|
predictorx login | Войти в систему и сохранить PAT |
predictorx auth status | Показать статус входа, пользователя и рабочую область |
predictorx auth logout | Удалить локальный PAT |
predictorx setup cloud | Быстрая настройка Предиктор Икс Cloud (вход + установка демона) |
predictorx setup self-host | Быстрая настройка для self-hosted бэкенда |
Рабочие области и участники
| Команда | Назначение |
|---|---|
predictorx workspace list | Список всех рабочих областей, к которым у вас есть доступ |
predictorx workspace get <slug> | Детали конкретной рабочей области |
predictorx workspace member list | Список участников текущей рабочей области |
predictorx workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."] | Обновление метаданных рабочей области (для админов/владельцев). Длинные поля принимают --description-stdin / --context-stdin. |
Задачи и проекты
Команды list (predictorx issue list, autopilot list, project list и т.д.) по умолчанию выводят короткие ID, готовые к копированию — например, ключи задач вроде MUL-123 для задач или короткие префиксы UUID для всего остального. Аргумент <id> в последующих командах принимает как короткий ID, так и полный UUID. Стандартный сценарий: predictorx issue list → копирование ключа → predictorx issue get MUL-123. Используйте --full-id в командах списка, если вам нужен канонический UUID.
| Команда | Назначение |
|---|---|
predictorx issue list | Список задач (выводит ключи, готовые к копированию) |
predictorx issue get <id> | Показать одну задачу (принимает ключ или UUID) |
predictorx issue create --title "..." | Создать новую задачу |
predictorx issue update <id> ... | Обновить задачу (статус, приоритет, исполнитель и т.д.) |
predictorx issue assign <id> --agent <slug> | Назначить агента (сразу запускает задачу) |
predictorx issue status <id> --set <status> | Быстрая смена статуса |
predictorx issue search <query> | Поиск по ключевым словам |
predictorx issue runs <id> | Показать запуски агентов по задаче |
predictorx issue rerun <id> | Перезапустить задачу для текущего агента |
predictorx issue comment <id> ... | Вложенные: просмотр / добавление комментариев |
predictorx issue subscriber <id> ... | Вложенные: подписка / отписка |
predictorx project list/get/create/update/delete/status | CRUD для проектов |
Агенты и навыки
| Команда | Назначение |
|---|---|
predictorx agent list | Список агентов рабочей области |
predictorx agent get <slug> | Показать конфигурацию агента |
predictorx agent create ... | Создать агента |
predictorx agent update <slug> ... | Обновить агента |
predictorx agent archive <slug> | Архивация |
predictorx agent restore <slug> | Восстановление архивированного агента |
predictorx agent tasks <slug> | Показать историю задач агента |
predictorx agent skills ... | Вложенные: прикрепить / открепить навыки |
predictorx skill list/get/create/update/delete | CRUD для навыков |
predictorx skill import ... | Импорт навыка с GitHub, ClawHub или локально |
predictorx skill files ... | Вложенные: управление файлами навыка |
Конфликты при импорте навыков
predictorx skill import --url <url> по умолчанию использует параметр --on-conflict fail. Если навык с таким именем уже существует, команда завершится с результатом conflict, не меняя рабочую область.
Используйте --on-conflict overwrite, если вы создали существующий навык и хотите заменить его содержимое, сохранив при этом его ID и привязки к агентам. Используйте --on-conflict rename, чтобы импортировать копию с автоматическим суффиксом, например -2. Используйте --on-conflict skip, чтобы оставить существующий навык без изменений и сообщить о пропуске (skipped).
predictorx skill import --url https://skills.sh/acme/repo/review-helper
predictorx skill import --url https://skills.sh/acme/repo/review-helper --on-conflict overwrite
predictorx skill import --url https://skills.sh/acme/repo/review-helper --on-conflict rename
predictorx skill import --url https://skills.sh/acme/repo/review-helper --on-conflict skipОтряды (Squads)
| Команда | Назначение |
|---|---|
predictorx squad list | Список отрядов в рабочей области |
predictorx squad get <id> | Показать один отряд |
predictorx squad create --name "..." --leader <agent> | Создать отряд (владелец / админ) |
predictorx squad update <id> ... | Обновление имени, описания, инструкций, лидера или аватара |
predictorx squad delete <id> | Архивация (soft-delete) — передает назначенные задачи лидеру |
predictorx squad member list/add/remove/set-role <squad-id> | Управление участниками отряда и их ролями |
predictorx squad activity <issue-id> <action|no_action|failed> --reason "..." | Используется агентами-лидерами для оценки работы на каждом этапе |
Подробнее в разделе Отряды.
Автопилоты
| Команда | Назначение |
|---|---|
predictorx autopilot list | Список всех автопилотов в рабочей области |
predictorx autopilot get <id> | Показать один автопилот |
predictorx autopilot create ... | Создать автопилот |
predictorx autopilot update <id> ... | Обновить |
predictorx autopilot delete <id> | Удалить |
predictorx autopilot runs <id> | Показать историю запусков |
predictorx autopilot trigger <id> | Запустить вручную |
Демон и среды выполнения (Runtimes)
| Команда | Назначение |
|---|---|
predictorx daemon start | Запустить демона (по умолчанию в фоне; добавьте --foreground для запуска на переднем плане) |
predictorx daemon stop | Остановить демона |
predictorx daemon restart | Перезапустить демона |
predictorx daemon status | Проверить статус демона и конкурентность |
predictorx daemon logs | Просмотреть логи демона |
predictorx runtime list | Список сред выполнения в текущей рабочей области |
predictorx runtime usage | Показать использование ресурсов |
predictorx runtime activity | Лог недавней активности |
predictorx runtime update <id> ... | Обновить конфигурацию среды выполнения |
Разное
| Команда | Назначение |
|---|---|
predictorx repo checkout <url> | Локальное клонирование репозитория для использования агентами |
predictorx config | Просмотр или изменение локальной конфигурации CLI |
predictorx version | Вывести версию CLI |
predictorx update | Обновить CLI до последней версии |
predictorx attachment download <id> | Скачать вложение из задачи или комментария |
Полный список флагов
Каждая команда поддерживает --help:
predictorx issue create --help
predictorx agent update --helpВо 2-й версии будет представлена детальная страница справочника для каждой команды.
Следующие шаги
- Аутентификация и токены — PAT vs. JWT vs. токен демона
- Демон и среды выполнения — как работают команды
daemon - Создание и настройка агентов — все опции для
predictorx agent create