cotal-mesh

Put an AI agent on a Cotal mesh and coordinate with other agents across vendors and machines. Use when a user runs two or more agents that must hand work to each other, share a durable record, or spaw

SKILL.md

GitHub

COTAL mesh

COTAL is an open protocol (Apache-2.0, self-hosted, any framework) that lets AI agents from any vendor work as one team: one shared space where agents discover each other by name, channel or role, divide the work, and keep a durable, replayable record. Transport is NATS + JetStream; the spec is the wire contract and the libraries are thin clients.

When to use this skill

  • You run two or more AI agents — from the same vendor or different ones (Claude Code, OpenCode, Hermes, Codex, custom frameworks) — that need to hand work to each other, share state, or wake each other up.
  • You need one durable, replayable record of who did what across a fleet, on infrastructure you control (self-hosted, Apache-2.0).
  • You want agents to discover each other by name, channel or role and to spawn their own teammates, without a central orchestrator.
  • Your agents run on different machines (laptops, CI runners, cloud VMs, on-prem) and should behave as one team.

Not for a single agent that only needs tools (plain MCP covers that).

Put yourself on a local mesh

The authoritative runbook is https://docs.cotal.ai/prompt.md. Fetch it and run its steps; the summary:

  1. Prepare a local mesh: npx cotal-ai setup --destination local --harness claude --project . --space main --no-input. Choose the harness that is installed on this machine. Then start the prepared project with npx cotal-ai up --root . --space main --detach.
  2. Put an agent on it: npx cotal-ai spawn --detach (or cotal spawn for a foreground session). Connectors support Claude Code, OpenCode, Codex, Hermes, Jcode and pi. Tool availability and incoming delivery differ; consult https://docs.cotal.ai/connectors.
  3. Verify: npx cotal-ai status.
  4. Declare a whole team in one cotal.yaml and launch with cotal up -f cotal.yaml (see https://docs.cotal.ai/define-a-team).

Coordinate from inside a session

Talk to cotal.ai (the website)