Команды Digit

Соседние страницы раздела объясняют, чем Digit подтверждает свои ответы. Эта — про то, что он делает, когда его зовут из терминала.

Весь вывод ниже снят с запущенного агента версии, которая стояла в момент написания страницы:

$ digit --version
Digit v0.19.8 (2026.8.2) · upstream 97e7a7fb · local 960f5279 (+6 carried commits)
Install directory: /home/m/projects/digit
Install method: git
Python: 3.12.13
OpenAI SDK: 2.24.0

Ничего не пересказано и не дописано для красоты. Где команда отказывается работать — приведён отказ.

Три способа позвать агента

digit                       # интерактивный диалог
digit -z 'вопрос'           # один запрос, в stdout только ответ
digit --tui                 # полноэкранный интерфейс в терминале

Одноразовый режим -z (он же --oneshot) сделан для скриптов и конвейеров: никакого баннера, спиннера, превью вызовов инструментов и строки session_id — только текст ответа. Инструменты, память, правила и AGENTS.md из текущего каталога при этом загружаются как обычно, а подтверждения действий автоматически пропускаются. К нему прилагается --usage-file PATH: после прогона туда пишется JSON с оценкой стоимости, числом токенов и числом вызовов API — причём пишется и когда прогон упал, чтобы конвейер всегда мог свести расходы.

Полезные флаги, действующие на один запуск и не трогающие конфиг:

Весь список команд

Их 72. Точнее: digit --help печатает 75 имён, но три из них — псевдонимы (learning и memory-graph зовут journey, gui зовёт desktop). Ниже — разбивка по тому, зачем за ними приходят; исчерпывающий перечень всегда печатает сам агент.

Разговор и сессии: chat, sessions, checkpoints, insights, prompt-size, logs.

Модель и провайдеры: model, moa, fallback, local, proxy, auth, login, logout, portal, migrate.

Навыки, инструменты, расширения: skills, bundles, plugins, curator, tools, mcp, hooks, sync, pets, skin.

Работа Digitable: kb, tasks, workbench, kanban, project, excalidraw, rule-check, spec, portrait, journey, memory.

Поверхности: desktop (он же gui), dashboard, serve, acp, gateway, slack, whatsapp, whatsapp-cloud, send, webhook, pairing, console, computer-use.

Обслуживание: setup, config, doctor, status, security, approvals, backup, import, import-agent, update, uninstall, profile, completion, dump, debug, monitoring, cron, secrets, egress, claw, version.

Дальше — подробно про те, за которыми приходят чаще всего и о которых больше нигде не написано.

digit excalidraw — схема из командной строки

Шесть наборов Мастерской, доступных не мышью, а строкой. Смысл команды объяснён в её собственной справке: рисование выражено командой, поэтому агент зовёт digit excalidraw … по навыку, а схема модельного инструмента — за которую платит каждый вызов API — не растёт.

$ digit excalidraw list
  mindmap    Интеллект-карта: тема, ветви, листья
             набор mindmap, фигуры по уровням: Центральная тема, Ветвь первого уровня, Подветвь, Лист
  sequence   Диаграмма последовательности: участники и вызовы
             набор sequence, фигуры по уровням: Участник, Заметка
  c4         C4: контекст, контейнеры, компоненты
             набор c4, фигуры по уровням: Система в фокусе, Контейнер, Компонент
  roadmap    Дорожная карта: дорожки, полосы работ, вехи
             набор roadmap, фигуры по уровням: Дорожка, Полоса работы, Веха
  flowchart  Блок-схема: начало, действия, развилки
             набор flowchart, фигуры по уровням: Начало и конец, Действие, Развилка
  kanban     Канбан-доска: колонки и карточки
             набор kanban, фигуры по уровням: Колонка с лимитом, Карточка задачи

Вход у всех шести один и тот же, и других форм нет:

Тема                       # уровень 0
  Ветвь                    # уровень 1, по отступу
    Лист                   # уровень 2
Ветвь -> Лист: подпись     # связь между подписями

Отступ задаёт уровень, уровень выбирает фигуру из набора. Стрелка соединяет две уже названные подписи и привязывается к обеим — непривязанная стрелка выглядит связью и связью не является.

Настоящий прогон. Восемь строк в файле схема.txt:

Портал Digitable
  Курсы
    FTS
    Системный дизайн
  Digit
    Навыки
    Модели
Digit -> Курсы: находит материал

$ digit excalidraw mindmap --text схема.txt --out карта.excalidraw
  набор: /home/m/projects/courses/static/workbench/excalidraw/mindmap-carbon.excalidrawlib
  элементов: 22; записан карта.excalidraw

Двадцать два элемента — это семь прямоугольников (по одному на подпись), восемь надписей (семь в фигурах плюс подпись на стрелке) и семь стрелок: шесть рёбер дерева и одна названная связь Digit -> Курсы.

Обратите внимание на первую строку вывода: команда взяла тот самый .excalidrawlib, который человек перетаскивает мышью в Мастерской. Второго набора фигур не заводится, поэтому нарисованное командой открывается и продолжается руками без шва.

Флаги у всех шести виджетов одинаковые: --text (файл со строками схемы или - для stdin) и --out — обязательные, --library (каталог наборов) и --palette со значениями carbon, paper, signal — нет. Каталога по умолчанию для вывода нет: файл пишется ровно туда, куда указали.

Коды возврата: 0 — записано, 1 — отказ, 2 — виджет не назван. Проверить команду на встроенном примере, ничего не записывая: digit excalidraw --self-test.

Когда пригождается. Разбор входящей задачи, который надо показать другому человеку: набросали иерархию текстом в редакторе за минуту, получили .excalidraw, открыли и подвинули пару блоков мышью. Обратная сторона — та же: агент, которого попросили «нарисуй, как это устроено», пишет те же восемь строк, а не двадцать вызовов инструмента рисования.

digit local — модель, которую агент ставит себе сам

Это не Ollama. Digit скачивает llama-server из llama.cpp, сверяет sha256, скачивает веса в формате GGUF и поднимает OpenAI-совместимый сервер на 127.0.0.1. Наружу не уходит ничего.

$ digit local status
llama-server не запущен (порт 8127)
бинарник: не установлен — поставится при `digit local start`
веса qwen3-4b-instruct-2507: не скачаны (2.3 ГиБ, окно 262144, порт 8127)
веса digit-router-0.6b: не скачаны (0.4 ГиБ, окно 40960, порт 8127)
веса specgen-qwen3-1.7b: не скачаны (1.2 ГиБ, окно 40960, порт 8128)

Три набора весов, и у каждого своя работа:

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

Маршрутизатор и генератор не могут быть основной моделью агента — их окно меньше требуемых Digit 64 000 токенов, и такая конфигурация отвергается на старте. Подробности про обе наши модели, вместе с замерами и границами, — на странице «Открытые модели и датасеты».

digit local start            # скачать чего не хватает и поднять сервер
digit local start --model router
digit local stop
digit local status

digit spec — спецификация FTS по заданию

Обученный генератор пишет документ FTS, но показывают вам его не сразу: сгенерированный текст компилируется настоящим компилятором, проверяется и его примеры исполняются — и только то, что прошло, попадает на экран. Что не прошло — генерируется заново; что не проходит никогда — отклоняется.

Задание пишется по образцу, на котором генератор обучен, и это ограничение названо в самой справке команды прямым текстом: на свободной формулировке он возвращает документ, который компилируется и при этом ничего не считает.

Флаги: --attempts N (сколько выборок пробовать до отказа, по умолчанию 2, и первая — жадная: настройка, на которой генератор измеряли), --out FILE.fts, --json, --no-autostart.

Коды возврата: 0 — проверено и напечатано, 1 — ни одна попытка не прошла гейт, 4 — проверка не состоялась вовсе (нет генератора, нет компилятора).

digit rule-check — правило по-русски против существующей спецификации

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

digit rule-check discount.fts 'если сумма заказа больше 1000, то прибавить 100'

Флаги: --utility (какую утилиту расширяем — нужен, только если спецификация объявляет больше одной), --category, --fts (напечатать ещё и скомпилированную спецификацию), --json.

Коды возврата: 0 — подтверждено, 1 — опровергнуто, 3 — не удалось формализовать, 4 — проверка не состоялась вовсе.

Четвёртый исход — главный, и на витрине раздела ему посвящён отдельный кадр: без установленного гейта команда отвечает «проверить нечем» и возвращает 4. Ветки «ответить без проверки» у этого слоя нет по устройству. Гейт ставится отдельно: digit mcp install fts-gate.

digit kb — поиск по корпусу курсов

Собственная база с поиском поверх нескольких чекаутов: материалы курсов, документы SDD, шаблоны Мастерской и документация языка. Что из этого у вас есть — показывает digit kb corpora.

digit kb index                 # первая полная сборка
digit kb update                # только изменившиеся файлы
digit kb search "горутины"     # ранжированные фрагменты с источниками
digit kb ask "...?"            # ответ со ссылками либо честный отказ
digit kb status                # размер индекса, модель, свежесть
digit kb doctor                # проверить модели и здоровье индекса

Команда сама объявляет, куда уходит корпус: эмбеддинги считает наш собственный сервер, синтез ответа — локальный ollama, и оба адреса сверяются со списком разрешённых, поэтому корпус может уйти только на loopback или на наши же проверенные хосты, но не к стороннему провайдеру.

digit tasks — задачи только по uuid

Общая база задач, с которой работают несколько агентов и владелец одновременно.

digit tasks list --project DIGIT
digit tasks add --project DIGIT 'что должно стать правдой'
digit tasks show <uuid>
digit tasks note <uuid> 'чем это подтверждается'
digit tasks done <uuid> --note 'чем это подтверждается'

Задача адресуется только uuid, и короткий позиционный номер команда отвергает с кодом 2. Причина названа в справке: Taskwarrior пересчитывает номера при каждом изменении списка незакрытых, поэтому номер, прочитанный до закрытия задачи, после него может указывать на другую. Команда отказывается вместо того, чтобы понадеяться на память вызывающего.

digit workbench — каталог интеграций

Читается прямо из чекаута курсов, поэтому путь назначения и шаги подключения ищутся, а не вспоминаются.

digit workbench list
digit workbench list --caveats
digit workbench show neovim
digit workbench search tmux
digit workbench categories

Карточки с пометкой ! несут оговорку — цель, где скопировать файлы недостаточно: мод клиента против правил сервиса, расширение, которому нужна ваша подпись, компонент, намеренно не попавший в платный архив. show печатает оговорку над шагами, а не под ними.

digit portrait — цифровой портрет владельца

Три раздельных слоя, и раздельность здесь — главное свойство:

digit portrait style        # слой 1: измеренная манера речи
digit portrait decisions    # слой 2: прежние решения, дословно, со ссылками
digit portrait draft        # слой 3: бриф + слот догадки
digit portrait on / off     # накопление
digit portrait forget       # убрать сессию или всё

Портрет намеренно не уезжает в системный промпт — поэтому смотреть его нужно отдельной командой. Накопление выключено по умолчанию.

digit mcp — внешние серверы инструментов

В каталоге восемь серверов, и вывод команды — их полный список:

$ digit mcp catalog

  MCP Catalog + configured servers:

  Name               Status                   Description
  ------------------ ------------------------ -----------
  blender            available                Drive a live Blender session — modeling, scenes, and renders.
  comfy-cloud        available                Generate images, video, audio, and 3D on Comfy Cloud.
  digit-tools        available                Route to 95 deterministic developer utilities — encoding, crypto, converters, network.
  figma              available                Official Figma remote MCP — design context, Code Connect, and write-to-canvas via https://mcp.figma.com/mcp (OAuth).
  fts-gate           available                Structurally verify FTS executable specifications and list domain morphisms.
  linear             available                Find, create, and update Linear issues, projects, and comments.
  n8n                available                Manage and inspect n8n workflows from Digit (stdio bridge, no public port).
  unreal-engine      available                Drive the Unreal Engine 5.8 editor over its local MCP server.

  Install: digit mcp install <name>    Picker: digit mcp

Ставится любой из них одной командой — digit mcp install <имя>; настройки уезжают в ~/.digit/config.yaml, секреты — в ~/.digit/.env. Остальные подкоманды: list, test, configure, remove, login, reauth, catalog, плюс digit mcp serve — выставить сам Digit наружу как MCP-сервер.

Два сервера из восьми — наши: digit-tools (роутер к каталогу утилит, отдельный репозиторий под GPL-3.0) и fts-gate (проверка спецификаций). Оба ставятся локально, в ~/.digit/mcp-servers/.

Blender стоит отдельного абзаца, потому что одной установкой дело не кончается. Сервер запускается как uvx blender-mcp==1.6.4 — версия закреплена, — но сам по себе он ничего не делает: внутри Blender должен стоять и быть включён аддон из того же проекта, а Blender — быть запущенным. Фоновый режим blender -b не годится: очередь команд висит на таймерах интерфейса. На машине без дисплея работает xvfb-run blender. Из двадцати двух инструментов сервера по умолчанию включены четыре — сведения о сцене, сведения об объекте, снимок вьюпорта и выполнение кода. Последний выполняет произвольный Python внутри Blender без песочницы, и манифест каталога об этом предупреждает прямо.

Чего на этой странице нет

Команд, которые я не запускал, здесь нет — ни digit doctor, ни digit setup, ни digit update: они пишут в ~/.digit, и приводить их вывод по памяти значило бы ровно то, от чего этот раздел отговаривает. Про установку и первый запуск написано отдельно, и там прогоны свои: «Установка» и «Первый запуск».