слишком много терминалов, щупалец не хватает

Octogent

Иметь десять открытых сессий Claude Code одновременно — то ещё удовольствие: постоянно переключаешься между ними и пытаешься вспомнить, что каждая из них должна была делать. Всё быстро размывается, когда один агент занимается документацией, другой трогает базу данных, третий меняет API, а четвёртый где-то во фронтенде. Octogent решает эту проблему, давая каждой задаче собственный изолированный контекст, заметки и список задач, а также позволяя Claude Code порождать другие агенты Claude Code, назначать им работу и обмениваться с ними сообщениями.

Концепция

Этот репозиторий — личное исследование того, как может выглядеть среда AI-разработки, когда терминальные агенты рассматриваются как части более крупного слоя оркестрации, а не как конечный интерфейс сам по себе. Цель не в том, чтобы спрятать Claude Code за абстракциями. Цель — сделать многоагентную работу менее хаотичной для разработчика на реальной кодовой базе.

Скриншоты

Что Octogent делает для вас

• Создаёт щупальца как слои контекста — агенты работают с изолированными markdown-файлами вместо широкого, запутанного контекста чата
• Использует todo.md как поверхность исполнения — задачи остаются видимыми, отслеживаемыми и готовыми к делегированию
• Запускает несколько терминалов Claude Code — один разработчик может координировать несколько сессий одновременно
• Порождает дочерних агентов из элементов todo — параллельная работа имеет конкретный источник истины
• Поддерживает межагентный обмен сообщениями — воркеры и координаторы могут сообщать о завершении, блокерах и передаче задач
• Хранит контекст агентов в файлах — система более устойчива, чем единый поток промптов
• Предоставляет локальный API и UI для управления жизненным циклом терминалов, персистентностью, websocket-транспортом и оркестрацией

Щупальце — это папка в .octogent/tentacles/<tentacle-id>/, содержащая читаемые агентом markdown-файлы: CONTEXT.md, todo.md и любые дополнительные заметки, необходимые для данного среза кодовой базы.

Метафора осьминога буквальна: один осьминог, много щупалец, разная работа происходит одновременно.

Щупальца

Щупальце — изолированный контейнер задачи. Оно даёт одному срезу работы собственные файлы, заметки и todo.md, чтобы агент не был вынужден восстанавливать весь контекст кодовой базы из истории чата.

Что оно делает:

• хранит контекст локально для одной области: документация, работа с базой данных, изменения API или фронтенд
• даёт агентам долговременные файлы, которые они могут читать и обновлять
• предоставляет естественный источник для делегирования через элементы todo

Полная модель описана в Tentacles и Working With Todos.

Контекст, заметки и списки задач

В Octogent щупальце — не просто корзина задач. Это также место, где задача хранит свой локальный контекст. Он может включать заметки об одной части кодовой базы, детали реализации, файлы передачи и todo.md, отслеживающий, что ещё нужно сделать. Агент Claude Code может читать и обновлять эти файлы по мере продвижения работы.

Это означает, что вы можете:

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

Полная модель описана в Tentacles и Working With Todos.

Claude Code управляет Claude Code

Одна из ключевых идей здесь состоит в том, что Claude Code не должен рассматриваться только как единственная терминальная сессия, ожидающая промпта от человека. В Octogent один агент Claude Code может координировать других агентов Claude Code, назначать им конкретные задачи и обмениваться с ними короткими сообщениями, пока человек остаётся на уровне оркестрации.

Это отличается от механизма порождения субагентов в Claude Code, поскольку позволяет напрямую видеть и контролировать, что делает каждый агент-воркер.

Таким образом, Octogent — не просто дашборд для нескольких терминалов. Это также способ структурировать поведение родитель-воркер вокруг изолированных задач и общих файлов контекста.

Текущая модель описана в Orchestrating Child Agents и Inter-Agent Messaging.

Как это работает

Octogent разделяет три аспекта, которые обычно смешиваются в кучу терминалов:

1. Контекст живёт в файлах внутри щупальца, а не в голове разработчика или в истории чата
2. Задачи отслеживаются в todo.md и могут быть делегированы дочерним агентам
3. Координация происходит через межагентный обмен сообщениями и API оркестрации

Для получения подробной информации об архитектуре см. документацию в папке docs/.