crossagent MCP server
Commit 23. Okt. 2026Paart zwei Coding-Agents in benachbarten tmux-Panes, um einen Driver-Reviewer-Workflow zu ermöglichen, bei dem jeder Plan und jeder Diff ein Urteil erfordert.
Auch bekannt als k8adev/crossagent
- Stars
- 7
- Tools
- 8
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 23. Okt. 2026
- Lizenz
- MIT
Was ist crossagent MCP?
crossagent ist ein MCP server. Paart zwei Coding-Agents in benachbarten tmux-Panes, um einen Driver-Reviewer-Workflow zu ermöglichen, bei dem jeder Plan und jeder Diff ein Urteil erfordert. Er stellt 8 Tools bereit, etwa ping, list_peers, send.
Zusammenfassung generiert aus dem README des Projekts
Über crossagent MCP server
crossagent ermöglicht es, zwei Coding-Agents in benachbarten tmux-Panes zu paaren, um einen Driver-Reviewer-Workflow zu etablieren. Dieses Setup erlaubt es einem Agent, Pläne oder Diffs vorzuschlagen, während ein zweiter Agent als Peer-Reviewer fungiert und sicherstellt, dass jede Änderung ein formelles Urteil erhält, bevor es weitergeht. Das Ganze läuft vollständig über tmux als Transportmechanismus, was bedeutet, dass keine Netzwerkverbindungen, gemeinsamen Dateien oder Sockets für die Funktion benötigt werden.
Entwickler, die Claude Code oder Codex CLI nutzen, können diesen Server integrieren, indem sie ihn via npx hinzufügen. Das System nutzt einen ping-Befehl zur automatischen Peer-Discovery innerhalb desselben git-Repositorys. Sobald sie verknüpft sind, nutzen die Agents Tools wie discuss, ask_review und list_peers zur Kommunikation. Das Protokoll erzwingt einen strikten Contract, bei dem jede Review mit einem spezifischen Urteil wie AGREE, ADJUST oder OBJECT abschließen muss, um die nächsten Schritte des Driver-Agents zu steuern.
Was du damit machen kannst
- 1Peer-Review für Code-Änderungen erzwingenLass die KI eine vorgeschlagene Implementierung an einen zweiten Agent zur formellen Bewertung senden.
- 2Veraltete Agent-Konversationen bereinigenWeise den Client an, den Gesprächsverlauf des Peer-Agents zurückzusetzen, um neu zu starten.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
crossagent MCP tools 8
Erkannt aus dem READMEpinglist_peerssendreadwait_replybriefdiscussask_review
| ping | — | |
| list_peers | — | |
| send | — | |
| read | — | |
| wait_reply | — | |
| brief | — | |
| discuss | — | |
| ask_review | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbark8adev/crossagent is public and reachablegithub.com/k8adev/crossagent ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-23github.com/k8adev/crossagent ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehencrossagent
crossagent pairs two coding agents running in adjacent tmux panes: one drives, the other reviews. Every plan and diff goes through the peer before it ships, and the reply always ends in a verdict. tmux is the only transport — no network, no shared file, no socket.
Install
Requirements: Node.js 22 or newer, tmux, and two panes each running a coding agent (Claude Code, Codex CLI), both inside the same git repository for automatic peer discovery. Each agent must call ping once — registration happens on that call, not on server startup.
Run npx from outside a clone of this repo — inside it, npx resolves the local package instead of the published one.
Step 1. Add the MCP server to each agent.
claude mcp add crossagent -- npx -y crossagent-mcp
codex mcp add crossagent -- npx -y crossagent-mcp
Step 2. Link the pair skill so both agents load the pairing protocol proactively.
npx -y crossagent-mcp setup --link
This symlinks skills/pair into ~/.claude/skills/pair, ~/.codex/skills/pair (or $CODEX_HOME/skills/pair) and ~/.agents/skills/pair. setup --unlink reverses it, removing only the symlinks it created.
Without step 2, the protocol is still available as the pair MCP prompt (/mcp__crossagent__pair in Claude Code). Details in docs/skill.md.
brief sends the harness's reset command to the peer pane (/clear for Claude Code, /new for Codex), clearing its current conversation. It is never needed for discuss to work and never runs automatically.
How it works
- ping — each agent registers its pane, harness and repository so the peer can be found.
- brief — resets the peer's conversation. Call it by hand only to clear a stale peer; it sends no role text.
- discuss — every round's task and context go here. Each message carries a short role brief (same-level copilot or reviewer bound to the
VERDICT:contract), so the peer needs no setup, and every plan or diff sent this way ends in one verdict line.
The last line of every review is VERDICT: <word>:
| Verdict | Meaning | Driver does |
|---|---|---|
AGREE |
No corrections. | Ships it as is. |
ADJUST |
Fine once the listed items are fixed. | Fixes them, or argues back when one is wrong. |
OBJECT |
Do not proceed as written, reasons included. | Reworks the plan and asks again. |
ESCALATE |
Only the human can call this one. | Stops and brings it to the user. |
UNPARSED |
Not a verdict — reply had no readable VERDICT: line. |
Asks again. |
The full round format, review extraction and verdict parsing are in docs/protocol.md.
Tools
| Tool | Description |
|---|---|
ping |
Registers this pane's identity and returns pane/harness/repo/mode. |
list_peers |
Lists other crossagent-visible tmux panes. |
send |
Sends literal text + Enter to a tmux pane. |
read |
Captures the last N lines from a tmux pane. |
wait_reply |
Waits until the peer pane's harness looks idle, returns the new content. |
brief |
Resets the peer pane's conversation (/clear, /new). |
discuss |
Sends a review round (role brief + message), parses the VERDICT: line. |
ask_review |
Alias of discuss with kind: "implementation". |
pair (prompt) |
The full pairing protocol as a single user message. |
Arguments and defaults: docs/tools.md. When pane is omitted, the target is the repo-scoped agent peer: shell panes are ignored, and with several agents the one in your own tmux window wins if it is the only one there.
Configuration
Optional config lives at ~/.config/crossagent/config.toml. Each harness's idle/busy detection regexes and its reset command (used by brief, e.g. /clear for Claude Code, /new for Codex) are overridable per harness, with tunable defaults for timeout, quiet period, and tail-window size. See docs/configuration.md for the full reference and examples.
How it finds the other pane
Each pane resolves its own tmux pane id, harness, and repo identity when ping is called, then self-declares them as tmux pane options so list_peers can find it. Codex CLI starts MCP servers lazily, so a Codex pane may not be discoverable by its declared identity until its first tool call. See docs/discovery.md for the full resolution logic and fallbacks.
Contributing
Bug reports, harness support, and protocol improvements are welcome. See CONTRIBUTING.md for dev setup, tests, and how to add a new harness. This project follows the Contributor Covenant.
Using another coding agent? Adding a harness means a detection entry in src/harness.ts and a config block; see CONTRIBUTING.md.
License
MIT
crossagent MCP Fragen
Welche Tools bietet crossagent MCP?
Er stellt 8 Tools bereit, darunter ping, list_peers, send, read, wait_reply.
Wie kommunizieren die Agents miteinander?
Die Agents kommunizieren über tmux als Transportmechanismus, was kein Netzwerk, keine gemeinsamen Dateien oder Sockets erfordert.
Welche Urteile kann ein Agent erhalten?
Die möglichen Urteile sind AGREE, ADJUST, OBJECT, ESCALATE und UNPARSED, wobei jedes eine spezifische Aktion für den Driver-Agent vorgibt.
Wie registriere ich meinen Agent beim Server?
Die Registrierung erfolgt, wenn jeder Agent einmal das ping Tool aufruft; dies geschieht nicht automatisch beim Serverstart.
Kann ich das mit anderen Agents als Claude Code oder Codex CLI nutzen?
Ja, du kannst Support für andere Agents hinzufügen, indem du einen Detection-Eintrag in der Harness-Config hinzufügst.