agentweave/cortex

README preview

# Cortex

Give your agents a chief of staff.

Cortex is an open protocol for coordinating AI agents through plain markdown files. It ships with a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin, but the protocol works with any agent runtime — Codex, Cursor, Gemini CLI, or anything that can read and write files.

A **chief of staff** agent manages **worker agents** across projects. The chief of staff receives your instructions, dispatches work to agents, and monitors progress — all through plain markdown with YAML frontmatter.

**Not using Claude Code?** See the [protocol spec](docs/protocol.md) and [adapter examples](docs/adapters/) for your runtime.

## How It Works

```
You --> Chief of Staff (Claude Code) --> Team Directory (markdown files) <-- Worker Agents (Claude Code)
```

- **Team directory** — a shared folder of markdown files. Agent notes, project notes, and task files. Can be an Obsidian vault, a git repo, or any directory.
- **Chief of staff** — a coordinator agent that receives your instructions, dispatches tasks to agent task files, and sends daily briefings. Talk to it via Telegram (recommended), terminal, or remote control.
- **Worker agents** — project-specific agents that poll their task file for work, execute tasks, and report status.
- **No direct agent-to-agent communication.** All coordination happens through the shared markdown files.

View full repository on GitHub →