concord-mcp

Посмотрите, как это работает

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

Claude Code → Concord   Claim src/app/page.tsx
Codex       → Concord   Claim src/app/page.tsx
Concord     → Codex     Overlap: Claude Code already owns this file
Codex       → Claude    I'll take src/app/api instead. Does that work?
Claude      → Codex     Yes. I'll keep the page and use your API contract.

Запустите реальное демо Claude Code ↔ Codex, чтобы увидеть, как оба агента разрешают пересекающееся требование через живой запрос/ответ, создают играбельное приложение, передают владение и передают результат независимому рецензенту.

Related MCP server: ccg-mcp-tool

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

npm install -g @concord-ai/concord-mcp
cd /path/to/your/repository
concord setup

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

concord setup создаёт локальное рабочее пространство .concord/, регистрирует MCP-сервер для Claude, Cursor, Gemini, Grok и Codex (.mcp.json, .cursor/mcp.json, .gemini/settings.json, .grok/config.toml и ~/.codex/config.toml) и записывает инструкции инструментов Concord в конфигурации ваших клиентов (CLAUDE.md, AGENTS.md, .codex/, .cursor/rules/). Он объединяется с существующей конфигурацией, а не заменяет её, и его можно безопасно запускать повторно.

Setup также обнаруживает поддерживаемые клиенты и пытается независимо установить их глобальные адаптеры Concord. Используйте --no-adapters, чтобы пропустить этот шаг, или --require-adapters в управляемых установках, которые должны завершаться ошибкой при сниженной поддержке. Передайте --no-mcp, чтобы записать только рабочее пространство и инструкции, управляя регистрацией MCP самостоятельно.

Поддерживаемые агенты

Не существует универсальной команды /concord — команды зависят от конкретного клиента. Concord работает через MCP-инструменты и установленные инструкции на любом клиенте с поддержкой MCP.

Живая доставка зависит от принимающей среды и состояния сессии. Запустите concord adapters status, чтобы увидеть, какие установленные агенты доступны и как будут доставляться сообщения.

Коммуникация — это отправная точка

Обмен сообщениями заставляет агентов разговаривать. Общее рабочее состояние Concord обеспечивает надёжность совместной работы после доставки сообщения.

Concord — это не ещё один автономный агент или оркестратор. Это общий слой вокруг ваших агентов: присутствие, обмен сообщениями, память задач, владение, передачи и состояние рецензирования через один небольшой MCP-сервер.

Инструменты

Записи принимают agent_id, что поддерживает присутствие активным просто работой. inspect_work показывает кто здесь и помечает устаревшие заявки — активную заявку, владелец которой ушёл без передачи.

Для живого общения агент-агент запустите concord setup, затем один раз перезапустите существующие сессии клиентов. Запрос использует update_work с operation: "prompt", целевым to_agent_id, содержимым и idempotency_key; ответ использует operation: "reply" и reply_to_message_id. Адаптер с подтверждением направляет занятый ход или запускает свободный ход. Интеграции только с хуками оставляют устойчивое сообщение для извлечения и указывают это ограничение в результате. Доставка немедленно завершается ошибкой, когда у указанного агента нет доступной конечной точки; Concord не перенаправляет его молча.

concord adapters status сообщает о каждой среде отдельно, включая её тип монитора/контроллера, проверенную доступность, необходимое действие и результат проверки версии. concord adapters install, doctor и uninstall обеспечивают тот же глобальный жизненный цикл вне настройки репозитория.

Concord автоматически определяет рабочее пространство репозитория. Операции возвращают его workspace_id и корень репозитория, чтобы клиент мог обнаружить неправильно направленный вызов; идентификатор можно передать явно, когда один сервер координирует несколько корней.

Операции, изменяющие жизненный цикл, используют монотонный version задачи как expected_version. Если два агента действуют на одной версии, только первый переход завершается успешно. Назначение оставляет работу в состоянии assigned, пока указанный агент не использует transfer_work с action: "accept"; предложение передачи также сохраняет владение у отправителя, пока получатель не примет. Каждое изменение владения сохраняется в журнале аудита, доступном только для добавления.

Что вы получаете

SQLite — это локальный источник истины, хранящийся в .concord/ в корне репозитория, в котором выполняется работа. MCP-сервер определяет этот корень из CONCORD_REPO_ROOT, если он задан, затем из CLAUDE_PROJECT_DIR Claude Code (который Claude Code устанавливает автоматически, даже для сервера, ограниченного пользователем), затем из его рабочего каталога — так что каждый агент в одном репозитории использует одно хранилище. Установите CONCORD_REPO_ROOT, когда сервер запускается в месте, где его рабочий каталог не находится внутри репозитория.

Связанные Git-рабочие деревья следуют метаданным commondir Git к основному чек-ауту, поэтому основной чек-аут и все связанные рабочие деревья намеренно используют одну базу данных Concord и один идентификатор рабочего пространства.

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

concord setup добавляет .concord/ в .gitignore репозитория, поэтому сгенерированное рабочее пространство по умолчанию остаётся локальным. Команды, которые хотят видеть выбранные артефакты в PR, могут удалить это правило или принудительно добавить человекочитаемые файлы:

.concord/
├── concord.db          local source of truth
├── HANDOFF.md          human-readable handoff
├── REVIEW_PACKET.md    review-ready evidence
└── WORK_STATE.json     generated export (optional)

CLI

Concord поддерживает как типизированные MCP-инструменты, так и обычный CLI. Агенты с поддержкой MCP могут вызывать инструменты напрямую; люди и агенты, ориентированные на CLI, могут работать с тем же общим рабочим пространством через команды concord.

concord setup                # set up local state, instructions, and MCP clients
concord status               # roster, active work, overlaps, stale claims, review-ready
concord dashboard            # live, keyboard-driven view of agents, tasks, alerts, and activity
concord who                  # which agents are present and what they are working on
concord tasks                # list all tracked tasks
concord handoff <task-id>    # print the latest handoff
concord review-packet <id>   # print the latest review packet
concord export markdown      # regenerate .concord/ artifacts
concord doctor               # workspace checks + per-task tool adoption
concord adapters status      # global harness delivery capability matrix

concord --repo ../project status        # select by repository path from anywhere
concord --workspace ws_... status       # select an id returned by a Concord operation

--repo и --workspace — глобальные взаимоисключающие опции. CLI использует тот же приоритет CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR → рабочий каталог и ту же канонизацию связанных рабочих деревьев, что и MCP.

concord dashboard — это локальный полноэкранный TUI только для чтения. Он обновляется из общего SQLite-рабочего пространства каждую секунду, сохраняя агентов, задачи, оповещения, контекст и временную шкалу в фиксированном окне терминала. Используйте Tab для переключения панелей, j/k или стрелки для выбора работы, / для фильтрации, ? для справки и q для выхода.

Обновление

npm install -g @concord-ai/concord-mcp@latest
concord --version

Concord проверяет ежедневно и отображает доступные обновления в CLI, MCP-инструментах и панели; concord setup может установить обновление с подтверждением, а CONCORD_NO_UPDATE_CHECK=1 отключает проверки.

Что это такое / чем не является

Общее рабочее состояние и память задач для агентов кодинга, использующих один и тот же локальный чек-аут. Не оркестратор, рецензент кода, хостируемый сервис синхронизации, векторная БД памяти или автономный агент кодинга.

См. также: Почему не просто markdown?

Участие

См. CONTRIBUTING.md и CLAUDE.md. Этот репозиторий строго типизирован (без any, без приведений типов) и модульный. Хорошие первые задачи помечены good first issue.

История звёзд

Конфиденциальность и телеметрия

Concord отправляет телеметрию продукта и координации на getconcord.ai. Она включает случайные идентификаторы установки/вызова; необратимые псевдонимы рабочей области и потока задач для каждой установки; версии Concord/Node/платформы; нормализованные метаданные клиента; имена операций, результаты и длительности; агрегированные результаты перекрытия/защиты от редактирования; этапы доставки сообщений и задержки; переходы жизненного цикла задач и затраченное время; а также явно сообщаемые результаты приемки, интеграции, вмешательства человека и переделки.

Concord никогда не отправляет код, исходные пути к файлам или репозиториям, удаленные репозитории, имена пользователей, исходные идентификаторы задач или агентов, идентификаторы сообщений или их содержимое, аргументы команд, входные/выходные данные инструментов или содержимое задач. Принимающий сервер хранит IP-адрес запроса и получает/хранит код страны. Эти серверные поля в настоящее время не имеют автоматического срока действия. Установите CONCORD_TELEMETRY_DISABLED=1 (или DO_NOT_TRACK=1), чтобы отключить телеметрию. Доставка осуществляется по мере возможности и никогда не может привести к сбою операции Concord.

Лицензия

MIT