zames_pro logo zames_pro
EN RU

Команды и инструменты

Все инструменты и слэш-команды zames_pro — терминального coding-агента без API-ключа.

Инструменты

У агента тот же стиль инструментов, что в Claude Code / Codex CLI:

  • Файловые — Read, Write, Edit, Bash, BashOutput, Glob, Grep. Read по умолчанию отдаёт сырое содержимое; передайте numbered=true, чтобы получить нумерацию строк в стиле cat -n (только для справки — не вставляйте её в Edit). Bash принимает run_in_background, а BashOutput затем опрашивает или убивает этот процесс.
  • Дополнительные — LS (список директории), MultiEdit (несколько правок одного файла атомарно), TodoWrite (чек-лист задач сессии), ApplyPatch (мультифайловый патч в формате V4A от Codex: *** Begin Patch … *** End Patch).
  • Git — GitStatus, GitDiff, GitLog, GitShow, GitBranchList, GitAdd, GitCommit, GitPush.
  • Web — WebFetch, WebSearch.
  • Субагенты — Task (делегировать самодостаточную подзадачу агенту в отдельном чате; explore только читает, general может править; число запусков на задачу ограничено).
  • Оператор — AskUser (модальный вопрос с вариантами; в режиме плана не предлагается, чтобы не прерывать план).
  • Служебный — respond (финальный ответ оператору, завершает задачу).

Все файловые инструменты остаются внутри рабочей директории (песочница). Write/Edit и MultiEdit/ApplyPatch делают резервную копию (undo) перед изменением файла.

Слэш-команды

Введите / в промпте для подсказок (Tab дополняет) — этот список всегда полный, а /help <команда> описывает любую одну из них. Кроме команд сессии и конфига (/new или /clear, /sessions, /chats, /resume-id, /last, /chat, /cd, /pwd, /status, /config, /undo, /undo-list, /rewind, /rewind-list, /transcript, /tasks, /mcp, /skills, /memory, /remember, /init, /reload, /debug-dom, /help, /exit) есть несколько в духе Claude Code / Codex CLI:

  • /diff [–staged] — показать git-диф рабочего дерева (–staged для индекса).
  • /diffstat — сводка изменений одной строкой (git diff --stat).
  • /context — показать, что загружено в промпт (AGENTS.md, MEMORY.md, навыки, пользовательские команды) и размер системного промпта.
  • /retry — отправить последнюю задачу в тот же чат заново (удобно после обрезанного или пустого ответа).
  • /rename — задать заголовок текущей сессии (виден в /sessions).
  • /copy — скопировать последний ответ ассистента в буфер обмена ОС.
  • /cost (алиас /usage) — статистика сессии: задачи, вызовы инструментов, длительность и размер контекста в токенах (у DeepSeek — accumulated_token_usage, у Qwen — input_tokens, у GLM — prompt_tokens).
  • /export [file] — записать транскрипт сессии в Markdown-файл (по умолчанию zames-export-.md).
  • /doctor — диагностика node, git, конфига, браузера, буфера обмена, MCP и активного провайдера чата (плюс состояние UI его страницы).
  • /provider <deepseek|qwen|glm> — сменить бэкенд чата (применяется сразу, без перезапуска); /provider status показывает активный провайдер/модель/вход; /provider login повторно проверяет вход. /model [id] покажет или выберет модель Qwen на лету.
  • /add-dir — проверить дополнительную директорию (песочница фиксируется при старте; для записи туда перезапустите с --dir).
  • /resume-id (или выбор чата в списке /chats) — открыть чат и НАПЕЧАТАТЬ его диалог в терминал, чтобы восстановленный контекст был виден. Показываются только последние 20 сообщений (`RESTORED_HISTORY_LIMIT`). /last открывает последний чат текущей директории без поиска; /sessions показывает сохранённые сессии с их относительным возрастом.
  • /help — полное описание одной команды (например, /help diff) вместо всего списка.
  • /review [focus] [–staged] — попросить агента проверить незакоммиченные изменения и сообщить находки (без правок кода).
  • /plan [on|off] — режим плана (только чтение). Пока он включён, мутирующие инструменты (Write/Edit/MultiEdit/ApplyPatch/Bash/BashOutput, GitAdd/GitCommit/GitPush, AskUser) убраны из набора вместе с MCP-инструментами с мутирующим именем, чтобы агент изучал код, не трогая дерево. Стартовать в нём можно с --plan.
  • /compact — попросить активный бэкенд сжать текущий чат в передаточное резюме, затем открыть НОВЫЙ чат, заново отправить системный промпт и положить резюме как перенесённый контекст. Используйте, когда контекст разрастается.
  • /goal <условие> — задать **условие завершения** (как в Claude Code). Агент сразу начинает работать над ним и продолжает запускать новые ходы, пока отдельная модель-оценщик не признает условие выполненным. Цель снимается автоматически при достижении (или если оценщик признал её недостижимой), либо командой `/goal clear` (синоним — `/goal off`). Условие хранится в `/.zames-goal` (git-ignored) и восстанавливается при следующем запуске. `/goal` без аргумента — или `/goal on` — показывает текущее состояние.
  • /loop — повторять задачу периодически (например, `/loop 10m run the tests`). /cron " " — запуск по расписанию. /jobs [rm |clear] перечисляет и останавливает их. Сработавшая задача попадает в ту же очередь сообщений, что и ваш ввод, так что выполняется, когда агент свободен (никогда посреди генерации), и всё равно соблюдает троттлинг отправки. ПЕРВЫЙ запуск `/loop` — сразу же (как только агент свободен); задача `/cron` ждёт своего расписания.
  • /thinking [on|off] и /web [on|off] — переключить режим размышления / веб-поиска. В DeepSeek это тумблеры «Deep thinking» / «Smart search»; в Qwen — это режим размышления (Thinking / Fast) и пункт «Web search» в меню «+». Их (а также /queue, /jobs, /goal, /config <sub>) можно использовать, ПОКА агент работает — они не трогают текущую генерацию.
  • /queue [list|ls|clear|c|clean] — показать (list/ls) или очистить (clear/c/clean) сообщения, ждущие отправки после текущей задачи.

Контекст в токенах показывается и вживую: в строке статуса над вводом слева спиннер/текст, справа — контекст (например, 125k · 13%). Процент считается от окна АКТИВНОГО провайдера — 1M у DeepSeek, у Qwen и GLM — своё значение на модель (qwen.contextLimit / glm.contextLimit). Он ОКРАШЕН по уровню заполнения: зелёный ниже 50%, жёлтый 50-80%, красный выше 80%. Значение приходит из счётчика токенов провайдера (у DeepSeek — accumulated_token_usage, у Qwen — input_tokens, у GLM — prompt_tokens) и скрыто до первого ответа.

Контекст проекта, навыки и память

Как в Codex / Claude Code, zames читает инструкции проекта и переиспользуемые процессы из вашего репозитория и из ~/.zames.

  • AGENTS.md — инструкции проекта, лежит в корне репозитория (или в любой родительской папке рабочей директории); агент создаёт его командой /init. Глобальные инструкции живут в ~/.zames/AGENTS.md (и ~/.claude/CLAUDE.md). Запустите /init, и агент изучит проект и напишет AGENTS.md на основе реальных команд сборки/тестов и соглашений (/init --force перезапишет существующий файл).
  • MEMORY.md — долговечные заметки, переживающие сессии. Агент дописывает сюда полезные факты по ходу работы; /remember <text> добавляет заметку из промпта — файл остаётся согласованным без ручного редактирования.
  • Навыки — папка с файлом SKILL.md (YAML-фронтматтер: name, description, опционально allowed-tools, user-invokable) плюс любые вспомогательные файлы. Ищутся в .zames/skills/, .claude/skills/, .agents/skills/, skills/ и ~/.zames/skills/. Агент читает тело только когда задача совпадает с описанием. Список — /skills; вызов — /<skill-name>.
  • Пользовательские команды — .md-файлы в .zames/commands/ (или .claude/commands/). Поддерживают подстановки $ARGUMENTS / `` и вызываются как /<command-name>.

Навыки и пользовательские команды видны в списке автодополнения «/» и в /help.

/skills                       список найденных навыков
/memory                       показать действующие AGENTS.md / MEMORY.md
/remember <text>              дописать долговечную заметку в MEMORY.md
/init [--force]               проанализировать проект и создать AGENTS.md