Установка и вход

CLI xflow это программа, через которую агент работает с платформой. Обычно всё на этой странице агент делает сам по инструкции getxflow.com/agent.md. От человека нужно одно: подтвердить вход в браузере.

Установка и вход

Нужен Node.js 20 или новее.

npm i -g @getxflow/cli
xflow --version
xflow login

xflow login печатает код и ссылку. Человек открывает ссылку, сверяет код и подтверждает вход. CLI хранит ключ организации в ~/.xflow/credentials.json. У участника один ключ на организацию: вход на второй машине выдаёт тот же ключ.

Команда	Что делает
xflow whoami	чей ключ, организация, тариф и лимиты с занятым
xflow logout	забыть ключ активной организации, --all забывает все
xflow org	организации с сохранённым ключом, активная помечена
xflow org switch <имя или id>	переключить активную организацию без браузера
xflow login ещё раз	войти в ещё одну организацию, CLI хранит по ключу на каждую

В папке проекта команды идут в организацию этого проекта, какая бы ни была активной. Если проект «не найден», хотя он есть, обычно ключ от другой организации: проверьте xflow org.

Инструкция для агента

xflow skills

Кладёт агентам на этой машине инструкцию о платформе (скилл). Без неё агент не знает про xflow. xflow init и xflow link раскладывают скилл сами.

Флаг	Что делает
без флагов	Claude Code, Cursor, Codex и всё уже установленное
--agent claude,cursor	только названные агенты
--global	в домашнюю папку, скилл виден во всех проектах
list	каким агентам и куда скилл уже разложен

Обновление

Команда	Что делает
xflow update	ставит свежую версию CLI и обновляет разложенные копии скилла

О новой версии CLI напоминает строкой не чаще раза в сутки. Ответ outdated_cli значит, что старая версия больше не работает: обновиться нужно сразу.

Переменные окружения

Переменная	Зачем
XFLOW_TOKEN	ключ там, где нет браузера (CI, сервер), главнее сохранённого
XFLOW_DEBUG	печатать стек при неожиданной ошибке
NO_COLOR	вывод без цвета