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

> Установить CLI xflow, войти в организацию и разложить агенту инструкцию о платформе.

> Оглавление всей документации: https://docs.getxflow.com/llms.txt

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

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

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

```bash
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`.

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

```bash
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` | вывод без цвета |