0.4.11
04 · Техническая документация

04. Slash-команды

Slash-команда вводится со слеша в начале строки ввода (/help, /cd src/). По мере набора всплывает список подходящих команд с локализованными (RU/EN) описаниями. Подробная справка по конкретной команде — /help <команда> (откроется на весь экран).

Как читать этот справочник

Для каждой команды указаны:

  • Синтаксис — что писать. Заглушки в квадратных скобках необязательны, в угловых — обязательны (например, /resume [идентификатор], /sandbox-add-read-dir <путь>).
  • Пример — конкретный ввод.
  • Что увидите — реакция: что откроется или что выведется в чат.
  • Доступность — когда команду можно вызвать:
  • когда агент свободен — только пока агент не выполняет задачу;
  • во время задачи — можно вызвать, пока агент работает над запросом;
  • в побочном разговоре — доступна ли внутри /side (см. раздел в конце — там доступно лишь несколько команд).

Если команда вводится не вовремя (например, требующая свободного агента — во время задачи), AstraCode не выполнит её, а покажет понятное сообщение вида «команда недоступна, пока выполняется задача».


Управление сессией

/new

Начать новый чат в той же сессии: контекст модели обнуляется, но цель (/goal) и доступ к прошлым сессиям через /resume сохраняются.

Пример: /new Что увидите: экран чата очищается, история разговора начинается заново; внизу — приглашение ввести новую задачу. Доступность: когда агент свободен; в побочном разговоре — нет.

/clear

То же, что /new, плюс очищает экран терминала.

Пример: /clear Что увидите: экран и контекст очищаются, начинается новый чат. Доступность: когда агент свободен; в побочном разговоре — нет.

/resume [идентификатор-или-имя]

Продолжить ранее сохранённую сессию.

Без аргумента открывает список сохранённых сессий. В каждой строке: дата создания/изменения (Tab переключает поле сортировки), git-ветка и рабочая директория, короткий фрагмент разговора. С аргументом сразу открывает нужную сессию по полному ID или началу имени треда (при неоднозначности берётся первое совпадение — в спорных случаях указывайте полный ID).

Пример:

text
/resume
/resume oauth-рефакторинг

Что увидите: без аргумента — список выбора сессий; с аргументом — восстановленная история выбранного разговора. Доступность: когда агент свободен; в побочном разговоре — нет.

/fork

Создать независимую копию текущей сессии — удобно для экспериментов, не трогая исходный тред.

Пример: /fork Что увидите: открывается копия текущего разговора как отдельная сессия; изменения в ней не влияют на оригинал. Доступность: когда агент свободен; в побочном разговоре — нет.

/rename [новый заголовок]

Переименовать текущий тред. Без аргумента откроется поле для ввода имени.

Пример:

text
/rename
/rename Миграция OAuth

Что увидите: заголовок треда меняется (виден в строке состояния/заголовке терминала, если он там включён). Доступность: в любой момент, в т.ч. во время задачи; в побочном разговоре — нет.

/compact

Просит текущую модель сжать предыдущие ходы в короткое резюме, чтобы освободить контекст.

  • Запускается серверной задачей и не отменяется после старта.
  • Резюме заменяет старые сообщения; самые свежие ходы сохраняются, чтобы разговор продолжался плавно.
  • Используется текущая модель сессии.
  • AstraCode сам предложит сжатие, когда тред приближается к model_auto_compact_token_limit из config.toml.

Пример: /compact Что увидите: в чат добавляется сообщение о сжатии, старая история сворачивается в резюме; счётчик контекста в строке состояния уменьшается. Доступность: когда агент свободен; в побочном разговоре — нет.

/quit / /exit

Корректно завершить работу AstraCode.

Пример: /quit Что увидите: TUI закрывается, управление возвращается в оболочку. Доступность: в любой момент, в т.ч. во время задачи; в побочном разговоре — нет.


Работа с кодом и проектом

/cd [путь]

Сменить рабочую директорию. Tab открывает автодополнение подкаталогов (повторный Tab спускается на уровень глубже). Понимает ~, .. и абсолютные пути.

Пример:

text
/cd src/auth
/cd ~/work/backend

Что увидите: рабочая директория меняется (видна в строке состояния), AstraCode перечитывает AGENTS.md нового каталога. Доступность: когда агент свободен; в побочном разговоре — нет.

/init

Просит модель сгенерировать файл AGENTS.md в текущей директории. В него попадают: обзор проекта (язык, фреймворк, структура), команды сборки и тестов, стиль кода, конвенции коммитов, рекомендации по тестированию.

Если AGENTS.md уже существует — команда ничего не делает и сообщает об этом (переименуйте или удалите старый файл, если нужен новый).

Пример: /init Что увидите: агент создаёт AGENTS.md; запросит подтверждение на запись файла (диалог подтверждения), затем покажет результат. Доступность: когда агент свободен; в побочном разговоре — нет.

/diff

Полноэкранный просмотр изменений: git diff по отслеживаемым файлам с подсветкой плюс новые (неотслеживаемые) файлы. Без фильтра по файлу — это весь набор изменений сразу. Закрытие — q или Esc.

Пример: /diff Что увидите: на весь экран открывается просмотрщик с цветным дельтой; прокрутка — стрелки/PgUp/PgDn. Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.

/review [уточнение]

Code review текущих изменений.

Без аргумента показывает меню из четырёх режимов: - Против базовой ветки — выбор ветки, ревью diff HEAD ↔ <ветка> (в стиле PR). - Незакоммиченные изменения — ревью текущего рабочего дерева. - Конкретный коммит — выбор коммита, ревью одного коммита. - Свои инструкции — свободный текст-задание ревьюеру.

С аргументом сразу запускает ревью по вашему тексту-инструкции.

Пример:

text
/review
/review проверь безопасность работы с токенами

Что увидите: без аргумента — меню выбора режима; затем (или сразу при аргументе) агент проводит ревью, и отчёт открывается на весь экран. Вывод-проза локализуется по языку интерфейса; имена полей JSON-схемы и сниппеты кода остаются на английском.

Модель: берётся review_model из config.toml, если задана; иначе — текущая. Лучше всего работает вместе со встроенными скиллами code-review, code-review-breaking-changes, code-review-change-size, code-review-context, code-review-testing. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/plan [инструкции]

Перейти в режим планирования: агент сначала излагает план, не трогая код, и ждёт вашего подтверждения. Требует включённой фичи collaboration_modes.

Пример:

text
/plan
/plan распиши шаги миграции на новый API логирования

Что увидите: агент отвечает планом (списком шагов) и не вносит изменений, пока вы не подтвердите. Доступность: когда агент свободен; в побочном разговоре — нет. Подробнее — 13-goal-and-modes.md.

/goal <цель> и подкоманды

Долгая цель с лимитом токенов, которая переживает /new и перезапуск. Подробнее — 13-goal-and-modes.md.

Форма Что делает
/goal Показать сводку по текущей цели (статус, формулировка, расход и лимит токенов)
/goal <цель> Задать цель
/goal --budget 200k <цель> Задать цель с лимитом токенов (суффиксы k, m)
/goal edit Отредактировать формулировку
/goal pause Поставить на паузу
/goal resume Продолжить
/goal clear Снять цель
/goal budget <токены или clear> Изменить или снять лимит токенов

Пример:

text
/goal Реализовать вход через OAuth
/goal --budget 300k Покрыть модуль платежей тестами
/goal

Что увидите: при постановке цели — подтверждение; если цель уже задана, /goal <новая> спросит подтверждение замены. Голый /goal печатает в чат текстовую сводку (Цель / Статус / Формулировка / Время / Токены / Бюджет), а если цели нет — подсказку по синтаксису и «цель ещё не задана». Статус показывается по-русски: «активна», «на паузе», «заблокирована», «остановлена по лимиту», «остановлена по бюджету», «достигнута». Доступность: в т.ч. во время задачи; в побочном разговоре — нет. Требует включённой фичи целей.

/index <подкоманда>

Построение и просмотр локального обзора модулей проекта.

Подкоманда Что делает
/index build Обходит проект (Cargo-workspace → отдельный crate → иначе по каталогам верхнего уровня), для каждого модуля просит субагент написать резюме на 5–15 строк и складывает результат в ~/.astracode/projects/<sha256(cwd)>/ (index.md + modules/<имя>.md + meta.json)
/index status Показывает число модулей, модель и время последнего построения
/index clear Удаляет обзор текущего проекта

Пример:

text
/index build
/index status

Что увидите: при build — прогресс в строке состояния, по завершении — сообщение в чат вида «Индекс проекта построен: N/M модулей → …»; при status — краткая статистика. Доступность: когда агент свободен; в побочном разговоре — нет.


Конфигурация

/model

Открывает выбор провайдера и модели — таблица из трёх колонок (Провайдер | Статус | Модели). Онлайн-провайдеры сразу показывают свои модели; провайдеры без ключа помечены Needs key, но их можно выбрать.

Действия (показаны внизу экрана):

Клавиша Действие
Enter Активировать выделенную модель
r Обновить список моделей у провайдера
d Удалить выделенного провайдера (и его сохранённый ключ)
Esc Отмена
+ Add provider Открыть форму добавления провайдера

Форма «Add provider» — три шага: Display name (имя, обязательно), Base URL (корень /v1, совместимый с OpenAI Chat Completions, обязательно), API key (необязательно; шифруется в ~/.astracode/secrets/local.age). Редактирования «на месте» нет — чтобы изменить провайдера, удалите (d) и добавьте заново.

Пример: /model Что увидите: список выбора провайдеров и моделей; после Enter выбранная модель активируется со следующего хода. Аргументы в строке не принимаются — /model gpt-5 вернёт ошибку «does not accept inline arguments». Доступность: когда агент свободен; в побочном разговоре — нет.

/locale [en|ru]

Сменить язык интерфейса. Без аргумента — выбор en/ru во всплывающем окне; с аргументом — переключение сразу.

Ограничение: доступна только до первого сообщения в сессии. После того как агент уже что-то делал, команда вернёт подсказку «сессия должна начаться раньше, чем можно сменить язык». Чтобы сменить язык в активной сессии: /new (или /clear), затем /locale ru. Переменная окружения ASTRACODE_LOCALE задаёт язык по умолчанию до запуска; /locale меняет его внутри уже запущенного TUI (но лишь до первого хода).

Пример:

text
/locale ru
/locale

Что увидите: интерфейс переключается на выбранный язык. Доступность: только до первого сообщения; в побочном разговоре — нет.

/theme

Выбор темы подсветки синтаксиса. Источники: встроенные темы и пользовательские файлы .tmTheme из ~/.astracode/themes/. По мере перемещения по списку подсветка обновляется вживую; Esc возвращает прежнюю тему, Enter сохраняет выбор в [tui].theme файла config.toml.

Пример: /theme Что увидите: список тем с живым предпросмотром подсветки. Доступность: когда агент свободен; в побочном разговоре — нет.

/title

Выбор (с множественным отметками) того, что показывать в заголовке терминала. Space — отметить пункт, Enter — сохранить. Доступные пункты: имя приложения, имя проекта, текущая директория, заголовок треда, git-ветка, модель, модель + reasoning, статус, спиннер, остаток/расход контекста, лимиты, токены, id сессии, режим fast, прогресс задачи, версия. Неприменимые пункты (например, git-ветка вне репозитория) скрываются. Сохраняется в [tui].terminal_title.

Пример: /title Что увидите: список переключаемых пунктов; после сохранения меняется заголовок окна терминала. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/statusline

То же, что /title, но для строки состояния внизу TUI. Space — отметить, Enter — сохранить, есть живой предпросмотр. Сохраняется в [tui].status_line.

Пример: /statusline Что увидите: список пунктов; нижняя строка состояния меняется сразу. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/keymap

Пошаговое переназначение клавиш TUI: выбор группы привязок → выбор действия (Set / Replace / Add alternate) → окно захвата следующей комбинации (поддерживаются модификаторы и последовательности вида Ctrl+X Ctrl+C). Конфликты проверяются до сохранения — диалог сообщит, какое действие уже занимает клавишу. Изменения пишутся в [tui.keymap] файла ~/.astracode/config.toml и применяются сразу.

Пример: /keymap Что увидите: иерархическое меню привязок; после захвата новой комбинации — сохранение или предупреждение о конфликте (текст локализован). Доступность: когда агент свободен; в побочном разговоре — нет.

/settings

Выбор микрофона/динамика для голосового режима. Доступна, только если включены голосовой режим и выбор аудиоустройств.

Пример: /settings Что увидите: список аудиоустройств для выбора. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/realtime

Включить/выключить голосовой режим (экспериментально, WebRTC). Требует включённой фичи голосового режима.

Пример: /realtime Что увидите: запускается (или останавливается) голосовая сессия. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.


Доступ и безопасность

/approvals / /permissions

Выбор готового пресета разрешений (это не настройка по отдельным инструментам).

Пресет Что разрешает
Read Only Только чтение рабочей директории; для изменения файлов нужно подтверждение
Default (по умолчанию) Чтение и запись внутри рабочей директории + запуск команд; для файлов вне неё — подтверждение
Full Access Изменение файлов вне рабочей директории без подтверждения; перед включением — предупреждающий диалог
Авто-проверка (если доступна) Те же права, что у Default, но подтверждения проходят не через вас, а через субагент-«страж» (см. /autoreview). Появляется в списке, только если настроена модель-страж

Выбор сохраняется в approval_policy и permission_profile файла config.toml. Переключение обратимо. Часть пресетов может быть неактивна с пояснением причины.

Пример: /approvals Что увидите: список пресетов; после выбора политика подтверждений меняется сразу. Доступность: когда агент свободен; в побочном разговоре — нет.

Обе команды ниже относятся только к Windows. На Windows песочница строится на «ограниченном токене» (restricted token) и бывает в трёх состояниях: выключена, ограниченная (RestrictedToken, она же «деградированная») и расширенная (Elevated). В ограниченном режиме агенту по умолчанию закрыт доступ к файлам вне рабочей директории. Эти две команды управляют таким доступом: /sandbox-add-read-dir точечно открывает чтение одной папки, а /setup-default-sandbox единоразово переводит песочницу в расширенный режим. На Linux/macOS обе команды не отображаются.

/sandbox-add-read-dir <абсолютный-путь>

Разрешить песочнице читать одну дополнительную директорию в текущей сессии. Это про доступ на чтение (read), а не на запись — writable_roots в конфиге не меняется, и в config.toml ничего не сохраняется: после перезапуска разрешение придётся выдать заново.

Требования к пути: - путь должен быть абсолютным (относительные отклоняются с ошибкой «path must be absolute»); - директория должна существовать и быть папкой (не файлом); - путь канонизируется автоматически.

Без аргумента команда лишь выведет подсказку по синтаксису.

Пример:

text
/sandbox-add-read-dir C:\data\reference

Что увидите: - в процессе — сообщение «Granting sandbox read access to C:\data\reference …»; - при успехе — «Sandbox read access granted for C:\data\reference», после чего агент может читать эту папку до конца сессии; - при ошибке (например, путь не абсолютный или не существует) — «Error: path must be absolute …»; - без аргумента — «Usage: /sandbox-add-read-dir <absolute-directory-path>».

Разрешение выдаётся без запроса прав администратора (не требует UAC) — это «лёгкая» операция поверх текущей песочницы. Доступность: только Windows; когда агент свободен; в побочном разговоре — нет.

/setup-default-sandbox

Единоразово настроить расширенную (elevated) песочницу на Windows — то есть перевести её из ограниченного (деградированного) режима в полноценный. Нужна, если по умолчанию AstraCode работает в ограниченном режиме restricted token и вы хотите более полную изоляцию агента.

Когда команда вообще доступна: только на Windows и только когда песочница сейчас в ограниченном режиме (RestrictedToken). Если песочница выключена или уже расширенная — команда не показывается и не выполняется.

Что происходит по шагам: 1. Если расширенная песочница на этой машине уже была настроена ранее — повторного запроса прав не будет: AstraCode просто переключит конфиг на расширенный режим. 2. Иначе ввод временно блокируется, показывается статус «Setting up sandbox…» с пометкой, что это может занять несколько минут. 3. Windows показывает диалог UAC (повышение прав) — настройка требует прав администратора. 4. При успехе расширенный режим включается и сохраняется в конфиге (windows_sandbox_mode = "elevated"), действует и в последующих сессиях. 5. Если вы отменили UAC или произошла ошибка — показывается предложение отката к прежнему режиму; система не меняется.

Пример:

text
/setup-default-sandbox

Что увидите: блокировку ввода со статусом «Setting up sandbox…», затем системный диалог UAC; по завершении — переключение в расширенный режим либо предложение отката при отмене. Доступность: только Windows и только в ограниченном режиме песочницы; когда агент свободен; в побочном разговоре — нет.

/autoreview

Относится к режиму авто-проверки (/approvals → «Авто-проверка»), где подтверждения действий агента обрабатывает субагент-страж: он сам разрешает или отклоняет действие. Команда /autoreview показывает список последних отклонённых стражем действий (до 10) и позволяет вручную разрешить один повтор выбранного.

Пример: /autoreview Что увидите: если отказов не было — сообщение «В этом треде нет недавних отказов авто-проверки». Если были — список отклонённых действий с обоснованием; после выбора AstraCode сообщит, что разрешение записано. Важно: повтор всё равно снова пройдёт авто-проверку. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/experimental

Всплывающее окно с переключателями экспериментальных функций (feature flags).

Пример: /experimental Что увидите: список экспериментальных функций с переключателями. Доступность: когда агент свободен; в побочном разговоре — нет.


Скиллы, агенты, MCP

/skills

Меню из двух пунктов (в русской локали):

  • Открыть список Skills — то же, что ввести $ в строке: список установленных скиллов для выбора. Само меню скиллы не устанавливает.
  • Включить/выключить Skills — экран переключателей с фильтром (введите > и текст для поиска); изменения сохраняются сразу.

Откуда подгружаются скиллы (по приоритету): <repo>/.astracode/skills/ (проектные) → ~/.astracode/skills/ (пользовательские) → ~/.astracode/skills/.system/ (встроенные, не редактировать). Установка из GitHub — встроенным скиллом skill-installer ($skill-installer), см. 05-skills.md.

Пример: /skills Что увидите: меню из двух пунктов; во втором — список скиллов с переключателями. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/agent / /subagents

Открывают список агентных тредов и позволяют переключиться между ними.

Почему это одна и та же команда

/agent и /subagentsдве формы (псевдонима) одной команды: в коде они ведут в один обработчик (AppEvent::OpenAgentPicker) и имеют одно описание «переключить активный агентный тред». Два имени оставлены для удобства: само окно списка называется «Subagents», поэтому /subagents так же естественно его открывает. Отдельной команды /agents (во множественном числе) нет — она не распознается.

Что такое «агентный тред» и кто их создаёт

  • Агентный тред — это отдельная ветка разговора. Всегда есть основной тред (в списке помечен Main [default]).
  • В ходе сложной задачи сама модель может запускать субагентов — дочерние треды со своей ролью (например, explorer — «исследователь», worker — «исполнитель»), чтобы распараллелить работу. Делает это модель инструментом spawn_agent, а не вы командой.
  • /agent и /subagents сами субагентов не создают — они только переключают, какой из уже существующих тредов вы сейчас видите. «Активный тред» — тот, чей разговор показан на экране.

Как работает выбор

  1. Вы вводите /agent (или /subagents).
  2. Открывается список «Subagents». В каждой строке: цветная точка статуса (зелёная — тред активен, тусклая — закрыт), имя (Main [default] для основного; для субагента — имя [роль]) и идентификатор треда.
  3. Выбираете тред — на экран выводится его разговор (история проигрывается заново). Туда же будет уходить ваш ввод.
  4. Между тредами можно переключаться и горячими клавишами Alt+← / Alt+→. Когда тредов больше одного, активный показывается в нижней строке состояния.

Конкретный пример

text
Вы: пройди по всему модулю оплат и найди, где не обрабатываются ошибки сети

Для большой задачи модель запускает субагента-исследователя. В чат приходит уведомление вида «запущен субагент explorer». Чтобы посмотреть, что он делает:

text
/agent

Откроется список:

text
Subagents
● Main [default]        3f2a…   (основной — ваш текущий разговор)
● Иван [исследователь]  a91c…   (субагент explorer, работает)

Выбираете Иван [исследователь] — на экране появляется его ход работы. Чтобы вернуться к основному разговору — снова /agentMain [default] (или Alt+←).

Что увидите: - если субагентов ещё нет — сообщение «No agents available yet» (пока модель никого не запускала); - если мультиагентность выключена фичей collaboration_modes — приглашение её включить (применится со следующей сессии: «Subagents будут включены в следующей сессии»); - иначе — список тредов; после выбора показывается разговор выбранного треда.

Доступность: в т.ч. во время задачи; в побочном разговоре — нет. Требует включённой мультиагентности (фича collaboration_modes). Подробнее о субагентах и инструменте spawn_agent18-tools-catalog.md и 19-agent-loop.md.

/mcp [verbose]

Только просмотр (инвентаризация) MCP-серверов — вывод печатается в чат, интерактивного меню нет.

Форма Что выводит
/mcp Серверы со списком их инструментов и статусом авторизации
/mcp verbose Дополнительно — полные описания инструментов и детали соединений

Добавить/изменить сервер этой командой нельзя. Настройка — в секциях [mcp_servers.*] файла ~/.astracode/config.toml или через CLI (astracode mcp add, вход — astracode mcp login <сервер>). После правки конфига перезапустите AstraCode.

Пример:

text
/mcp
/mcp verbose

Что увидите: в чат выводится список серверов и их инструментов; при неверном аргументе — подсказка «Usage: /mcp [verbose]». Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/apps

Список настроенных интеграций-коннекторов (например, мессенджеры, трекеры, почта). Только вывод в чат — добавлять/менять через команду нельзя. Настройка — в секциях [apps.*] файла config.toml; некоторые коннекторы требуют OAuth (запускается при первом использовании). Если коннекторы выключены, команда выведет короткое сообщение.

Пример: /apps Что увидите: список коннекторов и их статус. Доступность: в т.ч. во время задачи; в побочном разговоре — нет. Требует включённой фичи коннекторов.

/plugins

Просмотр плагинов. В текущей сборке отключено — команда выводит сообщение «меню /plugins отключено в этой сборке».

Пример: /plugins Что увидите: сообщение о том, что функция отключена. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/memories

Память по умолчанию выключена — это экспериментальная функция за feature-флагом memories (default_enabled: false).

Экран настроек памяти:

Элемент Тип Действие
Use memories переключатель Подмешивать накопленную память в новые треды
Generate memories переключатель Разрешить фоновое извлечение памяти из прошлых сессий
Reset all memories действие Очистить ~/.astracode/memories/ после подтверждения (необратимо)

Если функция выключена — вместо настроек показывается приглашение её включить (применяется со следующей сессии). Подробнее — 07-memories.md.

Пример: /memories Что увидите: либо приглашение включить функцию, либо экран с двумя переключателями и кнопкой сброса. Доступность: когда агент свободен; в побочном разговоре — нет.


Прочие

/side [сообщение]

Открыть временный побочный разговор — ответвление от основного треда (например, чтобы быстро что-то уточнить, не засоряя основную задачу). С аргументом сразу отправляет в него сообщение. Вложенные побочные разговоры запрещены; Esc возвращает в основной тред. Недоступна до старта сессии и во время code review (/review) — сначала закройте отчёт ревью.

Пример:

text
/side
/side как именно работает Arc<Mutex<T>>?

Что увидите: открывается отдельный мини-разговор (в строке состояния — пометка побочного режима); основной тред «не видит» этот вопрос. Подробнее — 13-goal-and-modes.md. Доступность: в т.ч. во время задачи; внутри другого побочного разговора и во время ревью — нет.

/collab

Сменить режим ответа (режим совместной работы). Требует включённой фичи collaboration_modes.

Пример: /collab Что увидите: список режимов для выбора (в TUI доступны «Обычный» и «Планирование»). Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/personality

В текущей версии не поддерживается — команда выводит сообщение-заглушку.

Пример: /personality Что увидите: сообщение, что функция пока не поддерживается. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/mention

Вставляет символ @, чтобы упомянуть файл (открывает выбор файла прямо в строке ввода).

Пример: /mention Что увидите: в строке ввода появляется @ и список файлов для выбора; то же делает ввод @ вручную. Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.

/copy

Скопировать последний ответ модели в буфер обмена (как Markdown). На Android команда скрыта.

Пример: /copy Что увидите: последний ответ агента копируется в буфер обмена. Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.

/help [команда]

Справка. Без аргумента — обзор всех команд; с аргументом — подробное описание одной команды (назначение, синтаксис, детали). Текст локализован.

Пример:

text
/help
/help review

Что увидите: без аргумента — обзорная страница на весь экран; с аргументом — подробная справка по команде. Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.

/status

Показать конфигурацию текущей сессии: модель, провайдер, режим песочницы, язык, расход токенов.

Пример: /status Что увидите: в чат выводится сводка по текущим настройкам и расходу токенов. Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.

/update

Проверить и установить обновление AstraCode прямо из TUI — принудительный запуск проверки и установки новой версии (аналог CLI-команды astracode update).

Пример: /update Что увидите: запускается проверка обновлений; если доступна новая версия — её установка, по завершении — сообщение о результате в чат. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/debug-config

Показать слои конфигурации и источники значений — удобно, чтобы понять «откуда взялся этот параметр».

Пример: /debug-config Что увидите: в чат выводятся слои конфига (managed → config.toml → проект → аргументы) с указанием, какой слой задал каждое значение. Доступность: в т.ч. во время задачи; в побочном разговоре — нет. (Это команда TUI; одноимённой CLI-команды astracode debug-config нет.)

/ps

Список фоновых терминалов, запущенных агентом.

Пример: /ps Что увидите: в чат выводится список фоновых процессов/терминалов. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/stop / /clean

Остановить все фоновые терминалы. /clean — псевдоним /stop.

Пример: /stop Что увидите: фоновые терминалы завершаются, в чат выводится подтверждение. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.

/feedback

Отправить отзыв сопровождающим. Два шага:

  1. Категория: Bug (креш/ошибка/зависание/сломанный UI), Bad result (мимо цели/неверно/неполно), Good result (полезный ответ), Safety check (безобидный запрос заблокирован проверкой), Other (медленно/UX/идея).
  2. Заметка (необязательная) — Enter отправляет, можно оставить пустой.

Отправляется только категория + заметка + лёгкие метаданные (версия, id треда, модель). Логи и транскрипт сессии не отправляются. Если сервер недоступен, заметка сохраняется в ~/.astracode/feedback_drafts/, чтобы вы не потеряли ввод. Если отзыв выключен в конфиге — команда покажет информационное окно и ничего не отправит.

Пример: /feedback Что увидите: выбор категории, затем поле заметки; после отправки — подтверждение. Доступность: в т.ч. во время задачи; в побочном разговоре — нет.


Отладочные команды (только debug-сборка)

Видны только при сборке с --features debug или при [features].debug_commands = true.

Команда Назначение
/rollout Показать путь к JSONL-файлу записи (rollout) текущей сессии
/test-approval Сгенерировать тестовый запрос подтверждения для проверки интерфейса
/debug-m-drop Отладочная команда работы с памятью
/debug-m-update Отладочная команда работы с памятью

Быстрые символы в строке ввода

  • Tab — открыть автодополнение команд / файлов / путей для /cd.
  • Ctrl-P / Ctrl-N — листать историю ваших запросов.
  • Esc дважды — прервать ответ модели.
  • Ctrl-C дважды — выйти из TUI.
  • @<файл> — упомянуть файл (как /mention).
  • $<скилл> — явно вызвать скилл.
  • !<команда> — выполнить shell-команду (с учётом песочницы).

Что доступно в побочном разговоре (/side)

Внутри /side доступны только: /help, /copy, /diff, /mention, /status. Остальные команды в побочном разговоре скрыты, но если ввести такую команду, AstraCode вернёт понятное сообщение «недоступно в побочном разговоре» (а не «неизвестная команда»).


Где определены команды (для разработчиков)

  • Перечень команд: astracode-rs/tui/src/slash_command.rs
  • Фильтры доступности: astracode-rs/tui/src/bottom_pane/slash_commands.rs
  • Диспетчер выполнения: astracode-rs/tui/src/chatwidget/slash_dispatch.rs
  • Тексты /help <команда>: astracode-rs/tui/src/help_text.rs

Чтобы добавить команду: (1) вариант в enum + RU/EN описание + флаги доступности, (2) ветка в диспетчере, (3) текст справки (обзор + детально), (4) обновить snapshot-тесты в slash_commands.rs.


CLI-команды (вне TUI)

Помимо slash-команд внутри TUI, у бинарника есть подкоманды для запуска из оболочки:

Команда Назначение Работает без лицензии?
astracode license status Показать состояние лицензии да
astracode license activate --file <путь> Активировать ключ из файла да
astracode update Обновить установку до последней версии в Package Registry да
echo $KEY \| astracode provider-secret set <id-провайдера> Записать API-ключ провайдера в ~/.astracode/secrets/local.age (ключ читается из стандартного ввода; флага --key нет) нет
astracode provider-secret delete <id-провайдера> Удалить ключ провайдера (есть также status / probe / probe-capabilities) нет
astracode app-server app-server без графического интерфейса (для IDE-интеграций, в т.ч. VSCode-плагина) нет
astracode mcp list\|get\|add\|remove\|login\|logout Управление MCP-серверами из оболочки нет
astracode debug app-server … Отладочные инструменты app-server (рядом — astracode debug models, astracode debug prompt-input) нет
astracode sandbox macos … / linux … Внутренние команды запуска песочницы (вызываются автоматически, не вручную)

«Работает без лицензии» означает, что команду можно выполнить без активной лицензии — иначе после смены машины было бы невозможно обновиться или активировать ключ. Подкоманда provider-secret скрыта из astracode --help и используется в основном внутренними сценариями TUI (форма /model, онбординг) и при необходимости из CI-скриптов.