# Команды

> Справочник консоли buff и команд внутри Buff Code: контекст, режимы, цель, побочный диалог, откат, Git, автоматизации, сценарии, расширения.

Здесь — команды консоли `buff` и команды внутри Buff Code, которые нужны для работы с
организацией: вход, контекст, модели, подключения. Полный список остальных команд
интерфейса показывает `/help`.

## Консоль

| Команда | Что делает |
| --- | --- |
| `buff` | открыть Buff Code в текущей папке |
| `buff <папка>` | открыть Buff Code в другой папке |
| `buff -c` | продолжить последнюю сессию в этой папке |
| `buff -s <id>` | продолжить конкретную сессию |
| `buff run "<сообщение>"` | выполнить одно задание без интерфейса и напечатать ответ |
| `buff models` | показать модели организации |
| `buff upgrade [версия]` | обновить Buff Code (`buff update` — то же) |
| `buff uninstall` | удалить консоль |
| `buff session list` | локальные сессии этой папки |
| `buff session export [id]` | выгрузить локальную сессию в JSON |
| `buff stats` | статистика использования на этой машине |
| `buff --version` | версия |

### `buff run`

Задание в одну команду — для скриптов, проверок и вопросов «на ходу»:

```bash
buff run "Найди, где считается скидка, и объясни формулу"
buff run -c "А теперь покажи тесты на неё"        # продолжить последнюю сессию
buff run --format json "..."                        # ответ и вызовы инструментов в JSON
buff run -f docs/spec.md "Сверь код с этим документом"
```

| Ключ | Что делает |
| --- | --- |
| `-c`, `--continue` | продолжить последнюю сессию |
| `-s`, `--session <id>` | продолжить конкретную сессию |
| `--fork` | ответвить сессию перед продолжением |
| `-m`, `--model` | модель в виде `buff/<имя>` — только из моделей организации |
| `-f`, `--file` | приложить файл к сообщению (до 100 раз) |
| `--format json` | вывод событиями JSON: текст, вызовы инструментов, результаты |
| `--title` | название сессии |
| `--thinking` | показывать рассуждение модели |

Особенности `buff run`, о которых стоит знать:

- нужен терминал: если входа и контекста ещё нет, `buff run` спросит их на месте, а без
  терминала откажет — сделайте первый вход через `buff`;
- **формы подтверждения отменяются**: `buff run` работает без вопросов к человеку, поэтому
  предложение модели [записать в базу знаний](/docs/buff-code/knowledge#как-появляется-новая-запись)
  в этом режиме не выполняется — запись возможна только в интерфейсе;
- сессия `buff run` записывается в кабинете так же, как любая другая.

## Команды внутри Buff Code

Набираются через `/` в строке ввода; есть и в палитре команд.

### Наши

| Команда | Что делает |
| --- | --- |
| `/org` | сменить организацию |
| `/project` | сменить проект или выбрать «Без проекта — только организация» |
| `/space` | выбрать пространства знаний организации |

Подробно — [Вход и рабочий контекст](/docs/buff-code/sign-in).

### Работа в сессии

| Команда | Что делает |
| --- | --- |
| `/mode` | режим разрешений: «Спрашивать», «Править сам», «Полный доступ» — см. [Режимы](/docs/buff-code/work/session#режимы-разрешений) |
| `/goal <что должно быть правдой>` | цель: агент делает ходы, пока проверка не подтвердит результат — см. [Цель](/docs/buff-code/work/plan-goal#цель) |
| `/side [вопрос]` | побочный диалог: вопрос по ходу работы, основная сессия не меняется — см. [Побочный диалог](/docs/buff-code/work/side) |
| `/todos` | список дел агента |
| `/queries` | перейти к одному из своих запросов в длинной сессии |
| `/btw <вопрос>` | разовый ответ по контексту сессии; в разговор он не попадает |
| `/undo`, `/redo` | откатить ход с предпросмотром или вернуть откаченное — см. [Изменения и откат](/docs/buff-code/work/changes) |
| `/compact` | сжать длинный разговор: свежая часть остаётся дословно, раннее — сводкой для модели |
| `/diff` | просмотр изменений |
| `/commit`, `/push` | коммит отмеченных файлов с подтверждением, отправка ветки |
| `/models`, `/variants` | модель организации и уровень рассуждения |
| `/new`, `/sessions` | новая сессия, другая сессия (в списке: `ctrl+f` — закрепить, `alt+a` — в архив, `ctrl+y` — архив) |

### Автоматизации, сценарии, расход

| Команда | Что делает |
| --- | --- |
| `/automations`, `/automation-new` | автоматизации по расписанию: список и новая — см. [Автоматизации](/docs/buff-code/work/automations) |
| `/workflows` | сохранённые сценарии и прогоны — см. [Сценарии](/docs/buff-code/work/workflows) |
| `/balance` | остаток организации, запас, тариф, оценка сессии и ваш расход по дням |

### Расширения

| Команда | Что делает |
| --- | --- |
| `/mcps`, `/mcp-add`, `/mcp-edit`, `/mcp-remove` | MCP-серверы: `buff`, `knowledge`, `repos` от организации и свои |
| `/skills`, `/skill-attach`, `/skill-detach` | навыки и каталоги навыков |
| `/command-add`, `/command-edit`, `/command-remove`, `/command-toggle` | свои команды |
| `/agent-add`, `/agent-edit`, `/agent-remove`, `/agent-toggle` | субагенты |
| `/hook-add`, `/hook-remove`, `/hook-toggle` | хуки |
| `/memory` | память `AGENTS.md`: заметка, включить или выключить |
| `/trust` | что из проекта ждёт проверки — хуки и команды |

Подробно — [Расширения](/docs/buff-code/work/extensions).

### Остальное

| Команда | Что делает |
| --- | --- |
| `/connect` | вход в Buff: строка «Buff · ваш логин · организация» или вход, если его ещё нет |
| `/settings`, `/themes` | настройки и тема |
| `/update` | обновить Buff Code |
| `/help` | все команды и сочетания |

Палитра со всеми командами — `ctrl+p`; смена агента (Build ↔ Plan) — `shift+tab`.

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

| Переменная | Что делает |
| --- | --- |
| `BUFF_CONNECTOR_URL` | адрес шлюза коннектора; форма входа его не спросит |
| `NODE_EXTRA_CA_CERTS` | путь к сертификату вашего центра сертификации, если он не в системном хранилище |