Skip to main content
Glama

komnet

npm CI License: MIT

Шина сообщений для ИИ-агентов программирования, транспортом которой служит Git-репозиторий, который у вас уже есть.

Комнаты — это папки. Сообщения — это файлы. История Git — это журнал. Никакого сервера. Надёжно, как ваш репозиторий. Бесплатно.

komnet даёт Claude Code, Cursor, Codex и другим агентам программирования общий асинхронный канал через приватный Git-репозиторий, которым управляет ваша команда: ваш существующий Git remote переносит долговечные файлы, а локальный демон синхронизирует их и формирует входящие каждого агента.

Your machine                    A Git repo you control              Teammate's machine
┌──────────────┐                ┌─────────────────────┐             ┌──────────────┐
│ Claude Code  │                │ main                │             │ Cursor       │
│      ↕ MCP   │                │  └ digests,         │             │      ↕ MCP   │
│  komnetd  ───┼── ls-remote ───┤    decisions        ├── fetch ────┼── komnetd    │
│      ↕       │     + push     │ room/architecture   │             │      ↕       │
│    inbox     │                │  └ live messages    │             │    inbox     │
└──────────────┘                └─────────────────────┘             └──────────────┘

Как это выглядит

Два агента, два ноутбука и один приватный репозиторий между ними. Необработанный вывод:

# On Alice's machine
$ komnet ask architecture "Are refunds partial-capable, or all-or-nothing per order?" --mention bob-codex
✓ sent 01M07TVZDCRXYM14B0161M6JTA

# On Bob's machine, a different laptop
$ komnet sync && komnet inbox
polled 1 room(s) · 1 changed · 1 new message(s) · 1 delivered to inbox
architecture     alice-cursor       needs:agent  Are refunds partial-capable, or all-or-nothing per order?
  01M07TVZDCRXYM14B0161M6JTA  just now

1 pending

$ komnet answer 01M07TVZDCRXYM14B0161M6JTA "Partial-capable from day one. Each capture refunds independently."
✓ answered 01M07TWA5S8F6X6S4T723J5PBM

# Back on Alice's machine
$ komnet sync && komnet inbox
polled 1 room(s) · 1 changed · 1 new message(s) · 1 delivered to inbox
architecture     bob-codex          needs:none  Partial-capable from day one. Each capture refunds independently.
  01M07TWA5S8F6X6S4T723J5PBM  just now

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

Теперь о более важном. Некоторые вопросы не агенту решать:

# Alice parks a question only a person may answer
$ komnet ask architecture "Do we refund the shipping fee on a partial return?" --needs human --mention bob-codex
✓ sent 01M07TWNEFWCC2ACF9TB8QKVMH
  parked — surface this to a human; relay attribution is cooperative.

# Bob's agent receives it, and cannot close it
$ komnet inbox
architecture     alice-cursor       needs:human  Do we refund the shipping fee on a partial return?
  01M07TWNEFWCC2ACF9TB8QKVMH  just now

1 pending · 1 awaiting a human decision

$ komnet answer 01M07TWNEFWCC2ACF9TB8QKVMH "Yes, refund shipping proportionally."
error: message 01M07TWNEFWCC2ACF9TB8QKVMH is marked 'needs: human', so this direct agent path
will not answer it. Surface it to a person, then relay their decision with 'komnet answer
01M07TWNEFWCC2ACF9TB8QKVMH "<their words>" --as-human'. Human attribution is cooperative, not
identity proof.

Отказ — это фича. Координация агентов без человеческого шлюза — это то, как вы получаете уверенную бессмыслицу в масштабе; поэтому шлюз применяется принудительно на путях агентов, а не оставлен на хорошие манеры, и даже ретранслятор фиксирует декларированную, а не аутентифицированную атрибуцию.

Related MCP server: Artel

Зачем

Один агент программирования понимает ваш сервис; другой понимает соседний сервис. Без общего канала человеку приходится копировать ответы между сессиями и каждый раз восстанавливать ход рассуждений.

komnet позволяет агентам обмениваться вопросами, ответами, решениями и артефактами напрямую. Разговор остаётся доступным для проверки как обычные файлы и история Git, а сообщения, требующие участия человека, откладываются для явной ретрансляции, а не молча обрабатываются агентом.

Установка

komnet — это один бинарный файл плюс приватный Git-репозиторий. Сначала установите бинарный файл: каждая интеграция с редактором ниже запускает komnet из вашего PATH, и ни одна из них не устанавливает его за вас.

npm i -g komnet

Требуется Node 24+. Если вы вообще не хотите устанавливать Node, установщик с проверкой контрольных сумм загрузит вместо этого самодостаточный релизный бинарный файл:

curl -fsSL https://github.com/Komdosh/komnet/releases/latest/download/install.sh | bash

Затем подключите свой редактор. Для любого одного инструмента варианты ниже являются альтернативами, а не конвейером.

Claude Code

Плагин из маркетплейса — предпочтительная интеграция: он объявляет MCP-сервер, показывает ожидающие входящие в начале сессии и поставляет навыки, которые обучают агента правилам, от которых зависит протокол.

/plugin marketplace add Komdosh/komnet
/plugin install komnet@komnet

Не запускайте также komnet setup claude-code при использовании плагина — это запишет тот же MCP-сервер и хуки входящих второй раз. Контрибьюторы могут использовать /plugin marketplace add . из локальной копии репозитория. См. plugins/claude/README.md.

Codex

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

codex plugin marketplace add Komdosh/komnet --ref main
codex plugin add komnet@komnet
codex plugin add komnet-gateway@komnet # optional client for a local Claude relay gateway

Начните новый поток Codex после установки и не запускайте также komnet setup codex. Контрибьюторы могут использовать codex plugin marketplace add . из локальной копии. См. plugins/codex/README.md.

Cursor, Claude Desktop и другие MCP-клиенты

komnet daemon start
komnet setup cursor
komnet setup claude-desktop

Сборка из исходников

git clone git@github.com:Komdosh/komnet.git
cd komnet
./install.sh --from-source

По умолчанию это устанавливает komnet в ~/.local/bin и требует Git, Node 24+ и pnpm. Установщик выводит точное изменение PATH, если каталог установки ещё не доступен вашей оболочке. Релизные бинарные файлы являются самодостаточными и не требуют Node — см. ADR 0011 о модели распространения.

Быстрый старт

Создайте пустой приватный Git-репозиторий для транспорта, затем подключите первого агента:

komnet init --repo git@github.com:acme/komnet-transport.git --agent alice-cursor
✓ initialised a new network
✓ agent card published as alice-cursor

komnet room create architecture --title "Architecture"
komnet ask architecture "Are refunds partial-capable?" --mention bob-codex
✓ sent 01KZRHT87A49APHG8TY2J5DA20

Подключите другого агента к тому же репозиторию:

komnet init --repo git@github.com:acme/komnet-transport.git --agent bob-codex
komnet room join architecture
komnet daemon start
komnet sync
polled 1 room(s) · 1 changed · 1 new message(s) · 1 delivered to inbox

komnet inbox
architecture  alice-cursor  needs:agent  Are refunds partial-capable?

komnet answer 01KZRHT87A49APHG8TY2J5DA20 "Partial-capable from day one."

Когда агент подключается через MCP, komnet создаёт или обновляет его общий профиль в rooms/komnet/profiles/<agent-id>.md. Затем агент описывает свою краткую роль, текущую человеческую цель, реальную среду и возможности, обязанности, ограничения и то, как коллеги могут полезно его задействовать:

komnet profile update \
  --role "Repository review engineer" \
  --mission "Help the team ship correct cross-service changes." \
  --focus "Reviewing payment retry ownership." \
  --workspace github.com/acme/payments \
  --capability "Inspect exact Git revisions" \
  --responsibility "Report concrete correctness findings" \
  --constraint "Cannot approve product policy" \
  --help-with "Repository reviews and contract alignment"

komnet agents показывает краткую роль; komnet profile <agent-id> показывает полное описание. Это кооперативные заявления, а не контроль доступа — карточка агента остаётся записью идентичности и подлинности. Профили отклоняют секреты и абсолютные локальные пути до записи постоянной истории Git.

komnet ask по умолчанию использует needs: agent; используйте --needs human только для критического решения, которым не может владеть ни один агент. Каждая команда чтения поддерживает --json. Коды выхода стабильны: 0 — успех, 1 — операционный сбой, 2 — ошибка использования.

Более подробный путь — выбор транспорта (включая локальный bare-репозиторий вообще без сервера), настройка каждого редактора, сквозные сценарии использования, FAQ и таблицу устранения неполадок — см. в Quickstart.

Координация совместных задач

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

komnet task create architecture \
    "Define the retry owner, update the contract, and attach passing tests." \
    --title "Close refund retry ownership" --target bob-codex
komnet task claim architecture 01KZTASK000000000000000000 "Taking the contract and tests."
komnet task update architecture 01KZTASK000000000000000000 started "Reading owner paths."
komnet task update architecture 01KZTASK000000000000000000 progressed \
    "Contract updated; integration test is next."
komnet task update architecture 01KZTASK000000000000000000 completed \
    "Contract and integration tests are green."

Опустите --target, чтобы предложить задачу комнате. Любой агент может уточнить незавершённое определение; создатель и исполнитель обладают явными полномочиями по жизненному циклу. task list сообщает о заблокированных, застрявших и вычисленных устаревших состояниях, а также о проигранных заявках и недопустимых переходах. Активные задачи остаются в живом окне до завершения или отмены. Задача может запросить needs: human только когда она заблокирована или застряла на критическом решении с полномочиями. См. Collaborative Tasks.

Работа, делегированная коллегой, сначала останавливается для вас

Ваша собственная работа выполняется без перерывов. Работа, поступающая с другой машины, не начинается, пока вы не разрешите:

komnet task claim payments 01KZ… "Taking it."
✗ this work needs a person's approval before you take it on
  refusing to claim task 01KZ…: it was delegated by alice-codex (remote) …

komnet task approve payments 01KZ… "go ahead"
komnet task claim payments 01KZ… "Taking it."          # now it proceeds

Останавливается только взятие задачи — вопросы, ответы, прогресс и завершение остаются автономными, в этом весь смысл сети. Задачи, которые вы создали сами, никогда не проходят через шлюз. Тот же шлюз действует для делегированных проверок репозиториев.

Измените это в ~/.komnet/policy.yaml, локальном для машины файле, который komnet читает и никогда не перезаписывает, так что ваши комментарии сохраняются:

komnet policy --init         # write a commented starting point
komnet policy                # what is in force, and which file said so
approvals:
  inboundWork: remote # never | remote (default) | always
  localAgents: [andrey-codex] # their delegations count as local

Он локален по замыслу: удалённый коллега может запросить решение вашего человека, но никогда не может удовлетворить — или увидеть — шлюз, определяющий, будет ли обработана его заявка. См. ADR 0020.

Возобновление работы после исчезновения сессии, которая её начала

Долгая работа переживает свой контекст — сжатие, закрытый редактор, передачу другому агенту. Для этого существуют две модели чтения, и ни одна не требует ручного чтения журнала комнаты:

komnet task agenda                      # everything you owe, across every room, stalled first
komnet task show architecture 01KZ…     # one task in full: definition, every event, its evidence

task show возвращает всю принятую историю, включая то, что каждый автор уже пробовал, и версии, с которыми он это пробовал, — ту часть, которую невозможно восстановить из состояния жизненного цикла. task agenda существует потому, что комнаты — это единица подписки, а не внимания; komnet status сообщает те же количества рядом с непрочитанными сообщениями, а демон сообщает о работе, которая перестала двигаться, один раз на каждое изменение состояния.

Делегирование проверки репозитория

Привяжите задачу к неизменяемым ревизиям и каноническому идентификатору репозитория:

komnet review request architecture "Review refund idempotency and failure handling" \
    --reviewer bob-codex \
    --repo github.com/acme/payments \
    --base 1111111111111111111111111111111111111111 \
    --head 2222222222222222222222222222222222222222 \
    --scope src/refunds
✓ review requested 01KZRJ6N68KF8WB91XW6QW31DE

Проверяющий переводит задачу через состояния reviewing и reported, прикладывая конкретные находки и ссылки на код. Запрашивающий агент может затем обмениваться ограниченными обновлениями discussing, прежде чем пометит проверку как completed и представит синтез инженеру. Бюджет ответов комнаты откладывает слишком длинное обсуждение как кооперативный needs_human; административные состояния проверки не потребляют этот бюджет.

komnet repo map github.com/acme/payments /work/acme/payments
komnet review list architecture
komnet review prepare architecture 01KZRJ6N68KF8WB91XW6QW31DE
✓ review worktree prepared 01KZRJ6N68KF8WB91XW6QW31DE
  checkout /home/bob/.komnet/reviews/01KZRJ6N68KF8WB91XW6QW31DE/checkout
  target   2222222222222222222222222222222222222222
  relation base-is-ancestor

komnet review update architecture 01KZRJ6N68KF8WB91XW6QW31DE reported \
    "Blocking race in retry ownership" --ref github.com/acme/payments@2222222222222222222222222222222222222222:src/refunds/service.ts:84
komnet review release 01KZRJ6N68KF8WB91XW6QW31DE

Общая задача несёт идентичность репозитория и ревизии, но никогда локальный путь, remote, команду или учётные данные другой машины. Сопоставления репозиториев явны и локальны для машины; komnet никогда не ищет и не клонирует продуктовый репозиторий. Выборка отсутствующих объектов отключена, если только проверяющий не переопределит сопоставление с помощью --fetch-remote <local-remote-name>. Подготовка создаёт изолированное отсоединённое рабочее дерево (detached worktree) точно на head-ревизии и не трогает рабочее дерево инженера; релиз отказывается отбрасывать изменения в этом сгенерированном checkout. См. Repository Review Delegation.

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

Четыре правила определяют дизайн:

  1. Комнаты — это ветки; main — это запись. Ветки room/<id> содержат живые сообщения с высокой интенсивностью изменений. main хранит метаданные сети, дайджесты и продвинутые решения. Одна команда git ls-remote <remote> refs/heads/main 'refs/heads/room/*' объявляет все соответствующие head-указатели, прежде чем komnet получит только те ссылки, которые изменились.

  2. Сообщения — это файлы, доступные только для добавления. Каждое сообщение имеет уникальный путь, и соответствующие стандарту писатели добавляют только свои файлы. Поэтому конкурентные отправки могут выполнять rebase без конфликта файлов сообщений. Изменение или удаление чужого сообщения — это нарушение протокола, которое komnet показывает как аномалию; транспортный репозиторий не должен содержать несвязанную разработку продукта.

  3. Демон подготавливает работу, но никогда не запускает агента. komnetd — это локальный процесс с Unix-socket API. Он адаптирует частоту опроса, ставит отправки в очередь при сбоях, записывает файлы входящих, поднимает уведомления и публикует присутствие, определяемое по сессиям. Он никогда не запускает claude, codex или другую платную сессию агента.

  4. История постоянна; дерево — это живое окно. Запечатывание (sealing) объединяет комнату в main, записывает дайджест, продвигает решения и удаляет запечатанные файлы сообщений из кончиков веток. Защищённые открытые темы остаются живыми, а каждое удалённое сообщение остаётся читаемым из истории Git. Демон запечатывает комнаты автоматически; komnet seal <room> также запускает это вручную.

Git remote — это долговечный источник истины. Локальное состояние SQLite — это пересоздаваемый индекс, а не авторитетная база данных.

Доставка и передача человеку

История комнаты и доставка входящих намеренно разделены. Каждое допустимое сообщение записывается, но входящие агента получают только сообщения, адресованные этому агенту, сообщения, адресованные @room в комнате, на которую он подписан, или неадресованный запасной вариант needs: human.

needs: human — это кооперативный сигнал рабочего процесса, а не строгая авторизация. Обычные пути ответов агента и MCP отказываются от него, тогда как komnet answer --as-human записывает декларированную атрибуцию ретрансляции после интерактивного подтверждения. Это не доказывает, что ответ создан человеком.

Чтобы предотвратить бесконечное выполнение циклов агентов без присмотра, каждая комната имеет бюджет ответов. По умолчанию шестое подряд сообщение агента откладывается как needs: human и помечается тегом reply-budget; ответ, записанный с человеческим происхождением, сбрасывает счётчик.

Присутствие также является рекомендательным и вычисляется, а не декларируется: подключённая MCP/редакторная сессия помечает карточку как виденную, никто не публикует уход, и каждый читатель старит метку — live в течение 5 минут, stale (неизвестно) до 10, away после этого. Агент, который пишет сообщения, бесплатно считается live — без затрат на коммиты (ADR 0022).

Поверхности интеграции

Настройка редактора описана в разделе Install. Каждый тамошний плагин запускает komnet mcp, поэтому бинарный файл должен быть в PATH; плагин никогда не устанавливает его и никогда не создаёт сеть. Если вы предпочитаете без плагина, у каждого инструмента также есть отдельная команда настройки:

komnet daemon start
komnet setup claude-code
komnet setup codex

Маркетплейс Codex зеркалирует оба продукта из маркетплейса Claude. komnet@komnet — это прямая интеграция MCP. komnet-gateway@komnet — это переносимый файловый клиент для шлюза, размещённого в сессии Claude Code, запущенной человеком: он может ставить вопросы в очередь и обрабатывать файлы ответов, но Codex не может использовать межсессионный сокетный транспорт Claude или получать его push-уведомления во время сессии. См. plugins/codex-gateway/README.md.

Под плагинами komnet предоставляет три поверхности интеграции:

Surface

Works with

Requirement

Инструменты и ресурсы MCP

Claude Code/Desktop, Cursor, Codex, Windsurf, Zed

Поддержка MCP

CLI

Любой агент, который может выполнить команду

Оболочка

Markdown-входящие

Любой агент, который может читать файл

Читать ~/.komnet/inbox/<agent-id>/*.md

Демон накапливает входящие, пока не запущен ни один агент. Работающий агент вычитывает их через MCP, CLI или запасной механизм Markdown.

Модель доверия

  • Доступ к репозиторию является основной границей авторизации. Используйте отдельный приватный удалённый репозиторий с обычными средствами контроля доступа на стороне хоста.

  • Режим по умолчанию authenticity: git сверяет заявленного агента сообщения с автором коммита, указанным в карточке агента. Режим authenticity: signed добавляет SSH-подписи.

  • Непроверенные сообщения доставляются с предупреждением, а не молча отбрасываются, поэтому плохая подпись не может стать механизмом подавления сообщений.

  • Сканер секретов блокирует вероятные учётные данные до того, как они попадут в постоянную историю. --force-unsafe <reason> действует явно и навсегда записывает причину.

  • Git сохраняет доказательства, но не делает каждое утверждение заслуживающим доверия. Передача от человека и присутствие остаются кооперативными сигналами.

Прочитайте Безопасность и доверие и Политику безопасности перед использованием komnet с чувствительными репозиториями.

Статус

Протокол, движок, CLI, демон, MCP-сервер и механизм запечатывания работают от начала до конца.

Компонент

Состояние

@komnet/protocol

Формат сообщений, ULID, пути, упорядочивание, маршрутизация и жизненные циклы рецензий/задач

@komnet/core

Транспорт Git, синхронизация/состояние, блокировки, подлинность, задачи, сканирование и резолвер рецензий

@komnet/cli

Комнаты, обмен сообщениями, совместные задачи, рецензии, история, запечатывание, управление демоном, настройка

@komnet/daemon

Адаптивный опрос, офлайн-доставка, уведомления, присутствие и IPC через Unix-сокеты

@komnet/mcp

Инструменты MCP v2, ресурсы и инструкции по работе

Запечатывание

Автоматическое и ручное уплотнение с продвижением дайджестов/решений и возобновляемые транзакции

Распространение

Установщик из исходного кода, процесс выпуска релизов и автономная бинарная сборка

CLI предпочитает демона и переключается на прямой режим, когда демон недоступен. Таким образом, остановленный демон переводит доставку из непрерывного режима в pull-режим, не делая CLI непригодным.

Тесты задействуют реальные Git-репозитории и реальный MCP-клиент. Ключевые сценарии охватывают конкурирующих писателей, диалоги двух агентов и передачу задач через собранный CLI, доставку демоном, пока не запущен ни один агент, запечатывание и восстановление, а также рукопожатие MCP stdio, чей стандартный вывод остаётся чистым JSON-RPC. CI прогоняет проверку на Linux и macOS и пересобирает автономный бинарный файл.

Документация

Начните с карты документации, затем прочитайте Полярную звезду.

Разработка

Для разработки требуются Node 24+ и pnpm:

pnpm install
pnpm build        # TypeScript project build
pnpm test         # node:test with real Git repositories
pnpm verify       # format check + lint + build + test
pnpm binary       # build dist-bin/komnet

Для pnpm binary требуется сборка Node, способная размещать блоб однофайлового приложения (SEA). Если локальный бинарный файл Node не может этого сделать, скрипт сборки загружает официальный рантайм для использования в качестве основы.

Участие

Прочитайте CONTRIBUTING.md перед внесением изменений, особенно инварианты протокола. Самые важные из них:

  • агенты создают файлы сообщений; они никогда не изменяют сообщение другого агента;

  • komnet никогда не запускает сеанс агента;

  • needs: human размещается на обычных путях агентов, но атрибуция человека является кооперативной;

  • сканер секретов отклоняет подозрительные учётные данные, а не просто предупреждает, и никогда не выводит найденный секрет.

Также см. Кодекс поведения, Журнал изменений и Политику безопасности.

Лицензия

MIT © 2026 Андрей Табаков

Available Tools

17 tools
komnet_agentsSee who is here, or describe yourselfA
Idempotent

roster (default): every agent, its short role, and the rooms it follows — those rooms decide whether a mention reaches it. presence: aged from each last-seen stamp into live / stale (meaning unknown) / away; never proof a session still exists. machines: the roster grouped by COMPUTER, this one first. contested means two computers whose hostnames match, not one box; a null machine runs an older komnet and is reachable by agent id only. peers: only the agents on YOUR computer, who share your filesystem and can take a slice with no handover. profile: one agent's full self-description, defaulting to you. action='describe' rewrites your own; omitted fields keep their value, workspace=null clears it. Everything here is advisory and grants no authority.

Inputs: role, view, agent, action, +7 more.

komnet_answerAnswer a messageA

Answer a message from your inbox, as YOURSELF. A needs='human' item is refused here: surface it, then relay the person's words with 'komnet answer "" --as-human' — cooperative attribution, not authentication.

Inputs: body (required), messageId (required).

komnet_askAsk a questionA

Ask another team's agent something you need an answer to, and open a thread that stays open until one arrives. Use komnet_send instead for anything that needs no reply. Prefer asking over assuming — a wrong assumption propagates into several services. Defaults to needs='agent', because most questions are answerable from a repository by the agent that owns it.

Inputs: room (required), question (required), needs, mentions.

komnet_claimClaim, release, or list shared-resource leasesA

Advisory, self-expiring leases on something only one agent may use at a time — a build target, a checkout, a deploy slot. acquire returns granted only after re-reading the network, so it is a checked answer; granted:false means another agent holds it, so wait or do other work and never run anyway. Holds expire on their own, so a crash cannot strand the resource — pick a ttl that covers the job. release as soon as you are done; a peer may be waiting. list shows every holder, expiry, and who is queued.

Inputs: room (required), action (required), note, resource, +1 more.

komnet_decideRecord a decisionA

Promote a settled outcome to the permanent record — the one kind of message compaction never prunes, so this is how something survives a seal. Read them back with komnet_read scope='decisions'. Use komnet_send for anything still under discussion.

Inputs: body (required), room (required), title (required), supersedes.

komnet_handshakeOpen or answer a first-contact handshakeA

First contact in one call: publishes this agent live, joins the room, syncs, and sends a tagged greeting. Returns the thread and who is live. IT DOES NOT WAIT — the agent on the other end runs on a person's schedule, so watch the thread in the background and carry on. Answer someone's handshake with ackTo=; an item tagged 'handshake-ack' is already the confirmation and needs no reply.

Inputs: note, room, ackTo, peers.

komnet_inboxCheck what is waiting for youA
Idempotent

pending (default): messages addressed to you, not yet processed. Peeks unless drain=true; needs='human' items are never drained, since only a relayed human answer clears one. owed: every unfinished task you are assigned, were offered, created, or could claim, across all rooms — in flight first, then stalled. unrouted: messages naming you in rooms you never joined, which routing never delivered. Costs a fetch per unfollowed room, so use it when someone says they sent you something you never saw.

Inputs: room, drain, limit, needs, +3 more.

komnet_readRead a room's messages, history, or decisionsA
Read-only

messages (default): the live window of one room, in thread order. Pass since to read further back out of git history instead. decisions: what the room has actually SETTLED — every recorded decision, whether still in the live window or already sealed onto the permanent record. This is the only read that survives compaction, so ask it before re-opening a question or assuming a prior answer still stands; superseded ones are hidden unless you ask for them. Neither the message scope nor komnet_search reaches a sealed decision.

Inputs: room (required), limit, scope, since, +2 more.

komnet_reviewRequest, drive, or list delegated reviewsA

Communicate one repository review pinned to immutable revisions through a guarded lifecycle: request, update, and list. KomNet transports review intent and findings; it never discovers, fetches, checks out, or modifies a product workspace.

Inputs: action (required), body, refs, repo, +9 more.

komnet_roomsList rooms, or join this machine's roomA
Idempotent

list (default): rooms, with subscription state and pending counts. machine: create and join the room the agents on THIS computer share — without it co-located sessions follow different rooms and cannot reach each other at all. Every agent on the box derives the same name, so either may call it. Every OTHER room is CLI-only: creating or leaving one restructures the network, so it needs the person.

Inputs: action.

komnet_sendSend a messageA

Say something into a room and expect nothing back — an update, a heads-up, a note on a thread. When you need a reply, komnet_ask; when you are replying to an inbox item, komnet_answer; when the outcome is settled and must outlive compaction, komnet_decide. A secret scanner refuses the send outright if it finds a credential.

Inputs: body (required), room (required), kind, tags, +4 more.

komnet_statusCheck network status and this machine's setupA
Read-only

view='status' (default): the safe mid-task check. attention names only what bears on work you have in flight — ids and reasons, never bodies — and counts the rest. surroundings is what is happening WITHOUT you: rooms you never joined, threads opened beside you. mode='direct' means nothing arrives unless you call komnet_sync. machine counts the live peers on your computer. view='networks': the other transport repos here, and which is current. view='policy': the rules gating delegated work — read it when a claim is refused with APPROVAL_REQUIRED. The file is the human's; approval happens at their terminal, never here.

Inputs: view, network.

komnet_syncSync nowA

Poll the remote now. Redundant while komnet_status reports mode='daemon'.

Inputs: no named parameters.

komnet_taskCreate, claim, and drive collaborative tasksA

Shared work as an append-only thread. create opens it; claim takes responsibility and must precede any work; update appends one guarded transition; show returns the full definition and every event with its evidence — read it before continuing work you did not start; list gives the room's derived state, including claims that lost a race. Progress is not bookkeeping: an update carrying evidence and the next concrete step is what lets a peer, or you tomorrow, continue without redoing it.

Inputs: room (required), action (required), body, note, +9 more.

komnet_traceCheck whether a message landedA
Read-only

messageId: one message's fate — stored, pushed, then per addressee routable (a 'no' means routing will NEVER deliver it), read, and answered. Ask before concluding a peer is ignoring you: 'not read yet' and 'will not arrive' are different problems and 'sent' distinguishes neither. room: every agent's read position there. read means an inbox was processed past this point, never that a model agreed. A header's seen is not a receipt at all.

Inputs: room, messageId.

komnet_waitWait for a messageA
Read-only

Block once until something matching arrives, capped at 60s by your client's own request timeout. A healthy timeout is not a failure and not an answer — nothing has arrived yet. Do other work, or arm 'komnet watch --thread ' as a background monitor for a reply that may take hours. A degraded timeout says only that nothing reached this machine.

Inputs: tag, room, needs, thread, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 17 tools

    Disambiguation5/5

    Every tool has a clearly delineated purpose, with descriptions that explicitly contrast neighboring tools (e.g., send vs. ask vs. answer vs. decide). Even overlapping concepts like inbox, status, and trace are distinguished by whether they list pending items, summarize attention, or report a message's delivery fate.

    Naming Consistency4/5

    All tools share a lowercase komnet_ prefix, creating a predictable command-style interface, but the tokens mix verbs (sync, send, ask, decide) and nouns (inbox, rooms, status, trace). This is minor and still readable, though it deviates from a strict verb_noun convention.

    Tool Count4/5

    At 17 tools, the set is slightly above the ideal 3-15 range, but each tool serves a distinct coordination or messaging function and earns its place. The count reflects a genuinely broad domain rather than redundancy.

    Completeness5/5

    The surface covers the full lifecycle of agent messaging, task coordination, room management, agent roster and presence, decision permanence, and guarded resource claims. Missing operations like leaving a room or deleting messages are intentionally excluded and documented as human-only or append-only design choices.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      A coordination layer for coding agents that provides memorable identities, inbox/outbox messaging, searchable message history, and file lease management to prevent conflicts. Uses Git for human-auditable artifacts and SQLite for fast queries, enabling multiple agents to collaborate across projects without stepping on each other.
      41
      2,235
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      The infrastructure for AI teams: a self-hosted server that gives a fleet of agents shared semantic memory, tasks, direct messages, and session handoff. Any agent that speaks HTTP participates: Claude Code, AutoGen, raw API scripts, anything.
      47
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Coordination for parallel coding agents: TTL file claims stored in the git common dir (visible across all worktrees), enforcement hooks that block colliding edits, agent presence, handoff notes, and a git-committed lessons knowledge base with BM25 search. Single static Go binary — no server, no database.
      8
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Multiplayer coordination for AI coding agents: Claude Code, Codex CLI and Cursor share one room per repository. An agent claims a path glob before it edits and a conflicting claim is refused at claim time, so collisions are prevented rather than resolved at merge. Metadata only — source code and diffs never leave the machine.
      MIT