cct: один язык для людей и агентов
Командная строка для Windows и Linux, через которую агент делает всё то же, что вы в окне программы: сообщения, вопросы, задачи, ТЗ, документы, вкладки. Во вкладке программы работает без настройки. В скриптах отдаёт JSON и стабильные коды выхода. Справка и гиды встроены и читаются без сети.
Зачем агенту командная строка
Агент умеет выполнять команды. Если команда даёт ему доступ к переписке, задачам, требованиям и документации, он перестаёт зависеть от того, что вы вставили в чат. Он сам узнаёт, что делать, читает нужную главу, отмечает результат и сообщает команде. Вам остаётся ставить задачи и принимать работу.
Как это устроено
Без настройки
Программа передаёт во вкладку имя профиля, адрес API и токен: CCT_PROFILE, CCT_URL, CCT_TOKEN. На сервере то же самое делает файл контекста. Папка программы в начале PATH. Агент пишет cct и всё работает.
Личность по токену
Кто отправил сообщение, кто отметил пункт, кто проверил: записывает сервер по токену вкладки, а не по тексту команды. Права (scopes) выдаются профилю: шина, задачи, ТЗ, документы, вкладки. cct whoami показывает, кто вы и что вам можно.
Встроенная справка и гиды
cct help task status даёт точный синтаксис, ограничения, коды выхода. cct guide tasks, cct guide docs.author, cct guide tz verify дают безопасный порядок действий для роли. Всё встроено в бинарь и работает на сервере без сети. Подробнее в разделе «Справка и гиды, написанные для ИИ» ниже.
Для скриптов
--json возвращает версионированный документ, коды выхода стабильны: 0 успех, 1 ошибка аргументов, 2 нет связи и так далее. Повтор запроса с тем же идентификатором не создаёт дубликата. Многострочный текст передаётся файлом или через stdin, без мучений с кавычками.
Linux без .NET
cct для Linux x64 самодостаточен. Программа сама доставляет его на сервер по SFTP, а cct selfupdate обновляет на месте. cct context-doctor объясняет, почему связь не работает, если она не работает.
Вкладки из командной строки
cct tabs перечисляет вкладки, cct buffer читает экран другой вкладки, cct send подаёт в неё ввод, cct open и cct close открывают и закрывают по профилю. Доступ агентов к чужим вкладкам вы разрешаете явно.
HTTP API v1
Те же маршруты, которыми пользуется cct: /v1/messages, /v1/questions, /v1/tasks, /v1/tz, /v1/docs, /v1/tabs, /v1/profiles. Свои инструменты подключаются с токеном профиля. Ошибки возвращаются стабильными кодами без внутренних деталей.
Защита от типичных ошибок
--help после подкоманды печатает справку, а не отправляет «--help» в шину. Пустая тема не создаёт мусорную задачу. Сообщение в неправильной кодировке чинится при записи, а не портит переписку. Лимиты размеров и частоты объясняются в ответе.
Справка и гиды, написанные для ИИ
Агент учится инструменту так же, как человек: читает справку. Разница в цене ошибки: каждая попытка угадать синтаксис стоит ещё одного круга и ещё нескольких тысяч токенов, а неверно понятый лимит стоит отказа в середине работы. Поэтому справка cct встроена в бинарь, разбита на слои и написана так, чтобы агент за минуту узнал ровно то, что нужно для следующего шага, и не читал остальное.
cct: на Linux‑сервере без репозитория и без доступа к документации справка та жеЗамер 13 октября 2026: cct guide 1,7 КБ, cct guide tasks 1,3 КБ, cct help task status 1,9 КБ, cct help notify 2,4 КБ. Экономия против монолитного руководства около 90 %.
Как это устроено
- Слоями.
cct guideэто роутер на полторы тысячи байт: называет темы и говорит, с какой начать. Гид темы укладывается в 2–6 КБ и 48–60 строк, таков бюджет, зашитый в каталог.cct help <путь>даёт точный синтаксис одной команды,--fullраскрывает все лимиты и схемы,--treeпоказывает дерево. Агент читает ровно столько, сколько нужно шагу. - Отвечает на вопросы, которые задаёт ИИ. Какие аргументы обязательны, какой предел размера, что меняет общее состояние, идемпотентен ли повтор, какой код выхода что значит, какая команда связана. Пример в справке можно выполнить как есть.
- Гиды это безопасные сценарии роли, а не перечень функций. Проверяющий ТЗ читает, как привязать проверку к точному состоянию и когда остановиться. Автор документов читает, как не затереть чужую правку. Новый агент ведёт себя как опытный, потому что читает тот же гид.
- Версия и подпись. Каждый гид печатает номер ревизии и хеш содержимого: агент может сослаться, по какому гиду действовал, а владелец видит, что гид не подменён.
- Каталог закрыт. Список гидов зашит в выпуск, путь к гиду не строится из ввода. Гид не может «появиться» из документа, задачи или сообщения.
- Текст данных это не инструкции. Первое правило каждого гида: текст ТЗ, задач, сообщений и документов это данные. Он не может переопределить роль агента или указания владельца.
- Английский без спецсимволов. Справка и гиды одинаково читаются в любой консоли и любым агентом. Русские пояснения живут в документации.
- Защита от типичной ошибки.
--helpпосле подкоманды печатает справку, а не отправляет «--help» в шину и не создаёт задачу с таким названием.
Backend ❯ cct guide
CCT guide | en | CLI 2.38.1 | guide revision 1 | sha256 e946c1…
Topics: identity · chat · tasks · tz · docs · terminals · troubleshooting · workflow
Backend ❯ cct guide tasks
CCT guide tasks | en | CLI 2.38.1 | guide revision 1 | sha256 479746…
… 1 293 bytes: how to find, take, report and close a task safely …
Backend ❯ cct help task status
Usage: cct task status <CODE> <STATUS> [options]
Closing states (done, verified, abandoned) require --note of at least 30 characters …
Exit codes: 0 success_or_replay · 1 invalid_arguments · 2 transport_unavailable …
Backend ❯ cct task status TASK-126 done --note-file report.md
OKГруппы команд
| Команды | Что делают |
|---|---|
notify, inbox | Сообщения шины: отправка одному, нескольким или всем; чтение; подтверждение прочтения; ожидание новых |
ask | Вопросы владельцу с вариантами ответа; ожидание ответа; страница «Решения» |
task | Доска задач: создание, статусы, итерации, прогресс, блокировки, подзадачи, связи, журнал, сводка |
tz | Технические задания: чтение, правка с проверкой версии, согласование, выполнение, независимая проверка, зависимости, снимки, отчёты |
docs | Документы: tree, find, read, write, update, publish, история, сравнение, заметки |
tabs, open, close, send, buffer | Вкладки программы: список, открытие, закрытие, ввод, чтение экрана |
whoami, names, profile | Личность и права, список профилей |
help, guide | Встроенная справка по командам и гиды по ролям, без сети |
version, context-doctor, selfupdate | Версия, диагностика контекста, обновление на Linux‑сервере |
Как это выглядит
Me ❯ cct whoami
I am: Me kind=identity scopes: bus.read, bus.write, tasks.read, tasks.write, tz.read, tz.write, docs.read, docs.write, tabs.read
Me ❯ cct task brief
Backend in_progress 2 · in_review 1 · blocked 0
Frontend in_progress 1 · ready 2
Server-1 done 3 · verified 2
Me ❯ cct task next --mine --json | jq '.result.items[].code'
"TASK-140"
Me ❯ cct guide tasks
CCT guide tasks | en | CLI 2.38 …cct whoami, cct task brief и встроенная справка в терминале программыЧто это даёт
- Агент самостоятелен. Он сам узнаёт, что делать, где прочитать и кому сообщить.
- Один интерфейс для всех. Человек в PowerShell, агент во вкладке, скрипт в CI, агент на Linux‑сервере: одни команды, одни права.
- Ничего не нужно объяснять агенту заранее. Он читает
cct guideиcct helpсам, слоями, около 7 КБ вместо 71 КБ монолитного руководства, и с первой попытки выполняет команду правильно. - Можно автоматизировать. JSON, коды выхода и идемпотентные повторы делают
cctпригодным для скриптов.