cospan

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 9 GitHub stars
Code Basarisiz
  • exec() — Shell command execution in dsh/index.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Unified orchestration across coding agents — connect Antigravity, Codex, Claude Code, and DeepSeek Harness through one async delegation protocol.

README.md

COSPAN

English | Simplified Chinese

Antigravity: plugin Codex: plugin
Claude Code: plugin DeepSeek Harness: plugin
license: MIT

Unified orchestration across coding agents.
Connect Antigravity, Codex, Claude Code, DeepSeek Harness, and more through one async delegation protocol.

Cospan orchestration adapter connecting Antigravity, Codex, Claude Code, and DeepSeek Harness

Why Cospan · Core CUJs · Install · Harnesses · Roadmap · References

Why Cospan

Frontier coding models perform best inside the native harnesses they were co-trained with—so the real unit of orchestration is Model × Harness, and different ecosystems bring distinct strengths: Gemini 4 Carbon (agy) for architecture and planning, GPT-6.2-Sol (codex) for deep bug-hunting review, GPT-6.1-Terra (codex) for live GUI and browser computer use, and Claude (claude) for frontend craft. Combining them unlocks massive leverage; humans can bridge harnesses manually with handoff prompts today, but orchestration belongs to the agents themselves.

Inspired and battle-tested by agy-staff, Cospan turns cross-harness delegation into an async, progressively disclosed protocol behind one unified adapter: your host dispatches peer Model × Harness units in the background, stays unblocked with a clean context window, and pulls live status or full execution traces only when needed—forming a clean foundation for next-generation multi-agent collaboration.

Why Cospan minimalist line-art diagram: moving from manual handoff ("You are the router") to Cospan ("Agents orchestrate peers") across Model × Harness units with async progressive disclosure

Core CUJs

Basic dispatch: one command, zero plumbing

Invoke /cospan-<harness> (or /cospan:<harness> in Claude Code, $cospan:<harness> in Codex) and specify any target model, reasoning effort, or timeout right in your prompt:

/cospan-codex Use sol (high effort, 20m timeout) to review src/webhook/ and flag real edge cases.

[!TIP]
Handled automatically under the hood (no need to manage this yourself): Your host agent autonomously frames context (inline text or --prompt-file), launches a detached background session (send), monitors progress non-blockingly (wait / bounded observe, inspecting full trajectory logs only if needed), and collects the result—or resumes the same session (continue) for follow-up turns.

Unified live sidebar (agy & dsh)

Installing on Antigravity (agy) or DeepSeek Harness (dsh) adds the unified Cospan sidebar panel—tracking live background runs across all four harnesses, inspecting Q&A outputs, and aggregating sibling Git worktrees (wt:*) in one view (Install ↓):

Unified Cospan sidebar panel inside Antigravity (agy) and DeepSeek Harness (dsh) tracking Codex, Claude Code, Antigravity worktree, and DeepSeek Harness tasks

Cross-ecosystem workflows

  • Parallel Review Fan out 2× Sol slice reviews from Carbon (Antigravity → 2× Codex) — Split deep code reviews across modules without blocking local tests; staggered async results merge cleanly on wakeup:

    /cospan-codex "Fan out 2 sol reviews across webhook/ and retry/ for real bugs."

    Gemini 4 Carbon uses 2 GPT-6.2-Sol reviewers to audit webhook/ & retry/ in parallel without blocking

  • Second Brain Multi-turn Carbon second brain for Astra (Codex ⇄ Antigravity) — Stress-test migration plans against a second model family and follow up in the same session while staying unblocked locally:

    $cospan:agy "Ask carbon to stress-test docs/plan.md, propose a cleaner route, and verify crash recovery."

    GPT-6.2-Astra consults Gemini 4 Carbon across 2 turns to stress-test docs/plan.md & verify crash safety

  • Computer Use Live browser & GUI testing via Terra (Claude Code → Codex) — Keep code and unit-test orchestration in Claude Sonnet, while GPT-6.1-Terra drives the live browser to catch layout bugs:

    /cospan:codex "Have terra open the local app and walk through the checkout coupon flow."

    Claude Sonnet uses GPT-6.1-Terra to drive the browser GUI, test SAVE20 at 375px, and catch a mobile CTA bug

  • Fast Sidecars Offload repo scans & race checks to protect Fable quota (Claude Code → Antigravity + DeepSeek Harness) — Save scarce flagship context and quota by delegating repo surveys and concurrency checks simultaneously:

    "Map auth token refresh with hydrogen and verify 401 race conditions with v4.1-flash."

    Claude Fable offloads auth mapping to Gemini 4 Hydrogen & race checks to DeepSeek V4.1 Flash in parallel

  • Full Pipeline End-to-end research & review pipeline from Carbon (Antigravity ⇄ Codex + ×N Antigravity) — Drive a full plan → gate → bulk experiment → final audit → fix pass loop across Astra, Hydrogen ×N, and Sol:

    "Have astra review my spec, fan out hydrogen across all experiment configs, audit with sol, and send sol's fixes back to hydrogen for one final pass."

    Carbon (host) plans with Astra, fans out Hydrogen ×N, audits via Sol, and passes fixes to Hydrogen

Install

Requires Node.js >= 20 plus whichever coding agent CLIs you want to connect (agy, claude, codex, dsh).

[!TIP]
Recommended — For agents: Paste this into any coding agent to let it detect your environment, install Cospan, and verify CLI contracts automatically:

Read the raw text of https://raw.githubusercontent.com/keli-wen/cospan/master/docs/INSTALL_FOR_AGENTS.md
(curl it — do not work from a summary) and follow it to install and verify Cospan for the harness you are running in.
Respond in the user's language.

Manual install

Antigravity (agy)

git clone https://github.com/keli-wen/cospan.git ~/.cospan/repo
node ~/.cospan/repo/bin/cospan.mjs install --host agy

Claude Code (claude)

claude plugin marketplace add keli-wen/cospan
claude plugin install cospan@cospan

OpenAI Codex (codex)

codex plugin marketplace add https://github.com/keli-wen/cospan
codex plugin add cospan@cospan

DeepSeek Harness (dsh)

dsh plugin --profile desktop add github:keli-wen/cospan

(Or in the DeepSeek Harness desktop app: Plugins → install from github:keli-wen/cospan.)

Restart Claude Code or Codex afterwards so the plugin loads (/cospan-… in Antigravity and DeepSeek Harness, /cospan:… in Claude Code, $cospan:… in Codex—or describe what you want in plain language).

Upgrading & diagnostics
  • Antigravity (agy): git -C ~/.cospan/repo pull --ff-only && node ~/.cospan/repo/bin/cospan.mjs install --host agy
  • Claude Code (claude): claude plugin marketplace update cospan && claude plugin update cospan@cospan
  • OpenAI Codex (codex): codex plugin marketplace upgrade && codex plugin add cospan@cospan
  • DeepSeek Harness (dsh): dsh plugin --profile desktop add 'github:keli-wen/cospan#<tag-or-commit>'

Claude Code and Codex cache plugins by version and require a restart after upgrading. Run node <cospan-repo>/bin/cospan.mjs doctor --check (zero tokens) at any time to verify installed CLI binaries and flag contracts; see docs/INSTALL_FOR_AGENTS.md for cache-refresh and Windows notes.

Harnesses

Harness Ecosystem Built-in model shortcuts
Antigravity (agy) Google · Gemini & Claude flash, neon, carbon, argon, hydrogen, opus, sonnet
Codex (codex) OpenAI · GPT sol, terra, astra, luna
Claude Code (claude) Anthropic · Claude sonnet, opus, haiku, fable
DeepSeek Harness (dsh) DeepSeek & custom providers v4.1-flash / flash, v4-pro / pro, <provider>/<model>

More harnesses are on the way—Cospan's driver layer is designed to plug in additional coding agent CLIs cleanly.

Roadmap

  • Cross-machine peer delegation over SSH — Fire-and-collect async task handoff across machines (LAN / Tailscale) via short-lived SSH, keeping remote credentials and execution isolated without long-lived connections.

References and License

  • agy-staff — Hire Google's Antigravity CLI (agy) as a fast worker and second brain across Claude Code, Codex, DeepSeek Harness, Pi, and OpenCode. Cospan generalizes the async jobs protocol and progressive disclosure architecture first pioneered and benchmarked in agy-staff (Bench v1 Tech Report).
  • Community — LINUX DO (Where possible begins, a developer & AI community).
  • License — MIT © 2026 Keli Wen · Release notes in docs/releases/ · Architecture & contributor guide in AGENTS.md.

Yorumlar (0)

Sonuc bulunamadi