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).
Пример:
/resume /resume oauth-рефакторинг
Что увидите: без аргумента — список выбора сессий; с аргументом — восстановленная история выбранного разговора. Доступность: когда агент свободен; в побочном разговоре — нет.
/fork
Создать независимую копию текущей сессии — удобно для экспериментов, не трогая исходный тред.
Пример: /fork
Что увидите: открывается копия текущего разговора как отдельная сессия; изменения в ней не влияют на оригинал.
Доступность: когда агент свободен; в побочном разговоре — нет.
/rename [новый заголовок]
Переименовать текущий тред. Без аргумента откроется поле для ввода имени.
Пример:
/rename /rename Миграция OAuth
Что увидите: заголовок треда меняется (виден в строке состояния/заголовке терминала, если он там включён). Доступность: в любой момент, в т.ч. во время задачи; в побочном разговоре — нет.
/compact
Просит текущую модель сжать предыдущие ходы в короткое резюме, чтобы освободить контекст.
- Запускается серверной задачей и не отменяется после старта.
- Резюме заменяет старые сообщения; самые свежие ходы сохраняются, чтобы разговор продолжался плавно.
- Используется текущая модель сессии.
- AstraCode сам предложит сжатие, когда тред приближается к
model_auto_compact_token_limitизconfig.toml.
Пример: /compact
Что увидите: в чат добавляется сообщение о сжатии, старая история сворачивается в резюме; счётчик контекста в строке состояния уменьшается.
Доступность: когда агент свободен; в побочном разговоре — нет.
/quit / /exit
Корректно завершить работу AstraCode.
Пример: /quit
Что увидите: TUI закрывается, управление возвращается в оболочку.
Доступность: в любой момент, в т.ч. во время задачи; в побочном разговоре — нет.
Работа с кодом и проектом
/cd [путь]
Сменить рабочую директорию. Tab открывает автодополнение подкаталогов (повторный Tab спускается на уровень глубже). Понимает ~, .. и абсолютные пути.
Пример:
/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).
- Незакоммиченные изменения — ревью текущего рабочего дерева.
- Конкретный коммит — выбор коммита, ревью одного коммита.
- Свои инструкции — свободный текст-задание ревьюеру.
С аргументом сразу запускает ревью по вашему тексту-инструкции.
Пример:
/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.
Пример:
/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> |
Изменить или снять лимит токенов |
Пример:
/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 |
Удаляет обзор текущего проекта |
Пример:
/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 (но лишь до первого хода).
Пример:
/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»); - директория должна существовать и быть папкой (не файлом); - путь канонизируется автоматически.
Без аргумента команда лишь выведет подсказку по синтаксису.
Пример:
/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 или произошла ошибка — показывается предложение отката к прежнему режиму; система не меняется.
Пример:
/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сами субагентов не создают — они только переключают, какой из уже существующих тредов вы сейчас видите. «Активный тред» — тот, чей разговор показан на экране.
Как работает выбор
- Вы вводите
/agent(или/subagents). - Открывается список «Subagents». В каждой строке: цветная точка статуса (зелёная — тред активен, тусклая — закрыт), имя (
Main [default]для основного; для субагента —имя [роль]) и идентификатор треда. - Выбираете тред — на экран выводится его разговор (история проигрывается заново). Туда же будет уходить ваш ввод.
- Между тредами можно переключаться и горячими клавишами Alt+← / Alt+→. Когда тредов больше одного, активный показывается в нижней строке состояния.
Конкретный пример
Вы: пройди по всему модулю оплат и найди, где не обрабатываются ошибки сети
Для большой задачи модель запускает субагента-исследователя. В чат приходит уведомление вида «запущен субагент explorer». Чтобы посмотреть, что он делает:
/agent
Откроется список:
Subagents ● Main [default] 3f2a… (основной — ваш текущий разговор) ● Иван [исследователь] a91c… (субагент explorer, работает)
Выбираете Иван [исследователь] — на экране появляется его ход работы. Чтобы вернуться к основному разговору — снова /agent → Main [default] (или Alt+←).
Что увидите:
- если субагентов ещё нет — сообщение «No agents available yet» (пока модель никого не запускала);
- если мультиагентность выключена фичей collaboration_modes — приглашение её включить (применится со следующей сессии: «Subagents будут включены в следующей сессии»);
- иначе — список тредов; после выбора показывается разговор выбранного треда.
Доступность: в т.ч. во время задачи; в побочном разговоре — нет. Требует включённой мультиагентности (фича collaboration_modes). Подробнее о субагентах и инструменте spawn_agent — 18-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.
Пример:
/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) — сначала закройте отчёт ревью.
Пример:
/side /side как именно работает Arc<Mutex<T>>?
Что увидите: открывается отдельный мини-разговор (в строке состояния — пометка побочного режима); основной тред «не видит» этот вопрос. Подробнее — 13-goal-and-modes.md. Доступность: в т.ч. во время задачи; внутри другого побочного разговора и во время ревью — нет.
/collab
Сменить режим ответа (режим совместной работы). Требует включённой фичи collaboration_modes.
Пример: /collab
Что увидите: список режимов для выбора (в TUI доступны «Обычный» и «Планирование»).
Доступность: в т.ч. во время задачи; в побочном разговоре — нет.
/personality
В текущей версии не поддерживается — команда выводит сообщение-заглушку.
Пример: /personality
Что увидите: сообщение, что функция пока не поддерживается.
Доступность: в т.ч. во время задачи; в побочном разговоре — нет.
/mention
Вставляет символ @, чтобы упомянуть файл (открывает выбор файла прямо в строке ввода).
Пример: /mention
Что увидите: в строке ввода появляется @ и список файлов для выбора; то же делает ввод @ вручную.
Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.
/copy
Скопировать последний ответ модели в буфер обмена (как Markdown). На Android команда скрыта.
Пример: /copy
Что увидите: последний ответ агента копируется в буфер обмена.
Доступность: в любой момент, в т.ч. во время задачи и в побочном разговоре.
/help [команда]
Справка. Без аргумента — обзор всех команд; с аргументом — подробное описание одной команды (назначение, синтаксис, детали). Текст локализован.
Пример:
/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
Отправить отзыв сопровождающим. Два шага:
- Категория: Bug (креш/ошибка/зависание/сломанный UI), Bad result (мимо цели/неверно/неполно), Good result (полезный ответ), Safety check (безобидный запрос заблокирован проверкой), Other (медленно/UX/идея).
- Заметка (необязательная) —
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-скриптов.