mclaude

Совместная работа в нескольких сессиях для Claude Code и других кодинг-агентов на базе ИИ. mclaude - это файловый слой координации на случай, когда два чата Claude работают над одним проектом - или двое коллег независимо запускают Claude Code, или один человек переключается между ноутбуками. Никаких сторонних зависимостей в ядре, 166 тестов, лицензия MIT.

Какую проблему решает

Вы просите Claude исправить баг. Через три минуты коллега с другого ноутбука просит своего Claude сделать то же самое. Ни один из них не подозревает о существовании второго. Открываются оба PR'а. Оба удаляют одну и ту же функцию. Конфликт слияния, упавшие тесты, а принятые решения заперты в двух историях чатов, которые больше никто не может прочесть.

Семь уровней

Каждый уровень решает одну задачу и может использоваться отдельно:

1. Блокировки задач (Work locks) - атомарное создание файлов (O_CREAT | O_EXCL) в .claude/locks/active-work/. Heartbeat обновляется каждые 30 секунд; блокировка считается устаревшей через 3 минуты. Вторая сессия, пытающаяся захватить тот же slug, видит, кто его держит, над чем работает, с какого момента и какие файлы затронуты.
2. Передача контекста (Handoffs) - при освобождении блокировки каждая сессия записывает markdown-файл передачи вида YYYY-MM-DD_HH-MM_<session-id-prefix>_<slug>.md.
3. Граф памяти (Memory graph) - общие знания, сохраняющиеся между сессиями.
4. Обмен сообщениями (mclaude mail) - вопросы и ответы между сессиями.
5. Hub-сервер - опциональная точка сетевой координации.
6. Bridge - коннектор для распределённой работы на нескольких машинах.
7. Голосовой ввод-вывод (Voice I/O) - аудиорасширение.

Все артефакты - это обычный markdown и JSON в .claude/, поэтому состояние проекта легко читается человеком и отслеживается в git.

Демо

Команда mclaude demo --no-pause разворачивает временную директорию, проводит две смоделированные сессии (ani и vasya) через шесть уровней координации и выводит диаграмму последовательности Mermaid с историей событий. Занимает около 30 секунд. Диаграмму можно сразу вставить в посты на GitHub или Habr. scripts/mclaude_watch.py запускается во втором терминале для наблюдения за демо в реальном времени.

Сопутствующие проекты

README связывает mclaude (рантайм - кто что делает и когда) с claude-code-config (сводом правил - 23 архитектурных принципа, 14 хуков безопасности, навык proof-verify). Параллельным сессиям особенно полезны destructive-command-guard, git-destructive-guard и git-auto-backup - они защищают общее состояние, пока mclaude координирует доступ к нему.

Интеграция с внешними таск-трекерами (Linear, Jira, GitHub, Vikunja) вынесена в примеры скриптов размером около 200 строк в examples/integrations/, которые команда может форкнуть под свои нужды. Сам mclaude к трекерам не обращается.

Контекст

По архитектуре это развитие файлового паттерна памяти, который jxnl описывает в jxnl-codex-maxxing. Если у jxnl vault - это записная книжка LLM, то mclaude ближе к ядру координации (атомарные блокировки, передача контекста с авторством, полка памяти и почтовый слой) на случай, когда этой записной книжкой пользуются сразу несколько агентов.

Тема примыкает к agent-principal-agent-problem (Крошоу о том, как агенты размывают сигнал об усилиях автора и ревьюера) и matryoshka-isolation (изоляция на уровне процессов). mclaude решает ортогональную задачу: когда у вас уже есть изолированный агент, который не разнесёт репозиторий, как скоординировать двух таких агентов, чтобы они не мешали друг другу?

Репозиторий: github.com/AnastasiyaW/mclaude - Python, лицензия MIT, авторский проект (6 звёзд на момент ingest'а)

Источник: mclaude-readme