crossagent MCP server
Commit 23 Okt 2026Memasangkan dua coding agent dalam pane tmux yang berdampingan untuk memungkinkan workflow driver-reviewer di mana setiap rencana dan diff memerlukan sebuah verdict.
Juga dikenal sebagai k8adev/crossagent
- Stars
- 7
- Tools
- 8
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 23 Okt 2026
- Lisensi
- MIT
Apa itu crossagent MCP?
Memasangkan dua coding agent dalam pane tmux yang berdampingan untuk memungkinkan workflow driver-reviewer di mana setiap rencana dan diff memerlukan sebuah verdict. Server ini menyediakan 8 tool, seperti ping, list_peers, send.
Ringkasan dibuat dari README proyek
Tentang crossagent MCP server
crossagent memungkinkan Anda memasangkan dua coding agent dalam pane tmux yang berdampingan untuk membangun workflow driver-reviewer. Setup ini memungkinkan satu agent untuk mengajukan rencana atau diff sementara agent kedua bertindak sebagai peer reviewer, guna memastikan setiap perubahan menerima verdict formal sebelum dilanjutkan. Sistem ini beroperasi sepenuhnya melalui tmux sebagai mekanisme transport, yang berarti tidak memerlukan koneksi jaringan, file bersama, atau socket untuk berfungsi.
Developer yang menggunakan Claude Code atau Codex CLI dapat mengintegrasikan server ini dengan menambahkannya via npx. Sistem ini mengandalkan perintah ping untuk discovery peer secara otomatis di dalam repositori git yang sama. Setelah terhubung, para agent dapat menggunakan tool seperti discuss, ask_review, dan list_peers untuk berkomunikasi. Protokol ini menerapkan kontrak yang ketat di mana setiap review harus diakhiri dengan verdict spesifik seperti AGREE, ADJUST, atau OBJECT untuk memandu langkah selanjutnya dari driver agent.
Apa yang bisa Anda lakukan dengannya
- 1Menerapkan peer review untuk perubahan kodeMinta AI untuk mengirimkan usulan implementasi ke agent kedua untuk mendapatkan verdict formal.
- 2Membersihkan percakapan agent yang sudah usangInstruksikan client untuk mereset riwayat percakapan peer agent agar bisa memulai dari awal.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool crossagent MCP 8
Terdeteksi dari READMEpinglist_peerssendreadwait_replybriefdiscussask_review
| ping | — | |
| list_peers | — | |
| send | — | |
| read | — | |
| wait_reply | — | |
| brief | — | |
| discuss | — | |
| ask_review | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauk8adev/crossagent is public and reachablegithub.com/k8adev/crossagent ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-23github.com/k8adev/crossagent ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubcrossagent
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
Pertanyaan tentang crossagent MCP
Tool apa yang disediakan crossagent MCP?
Server ini menyediakan 8 tool, termasuk ping, list_peers, send, read, wait_reply.
Bagaimana cara para agent berkomunikasi satu sama lain?
Para agent berkomunikasi menggunakan tmux sebagai mekanisme transport, sehingga tidak memerlukan jaringan, file bersama, atau socket.
Apa saja kemungkinan verdict yang bisa diterima oleh sebuah agent?
Kemungkinan verdict yang tersedia adalah AGREE, ADJUST, OBJECT, ESCALATE, dan UNPARSED, yang masing-masing menentukan tindakan spesifik bagi driver agent.
Bagaimana cara mendaftarkan agent saya ke server?
Registrasi terjadi saat setiap agent memanggil tool ping satu kali; proses ini tidak dilakukan secara otomatis saat server startup.
Bisakah saya menggunakan ini dengan agent selain Claude Code atau Codex CLI?
Ya, Anda bisa menambahkan dukungan untuk agent lain dengan menambahkan entri deteksi pada konfigurasi harness.