agent-collab
Health Gecti
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 29 GitHub stars
Code Basarisiz
- fs.rmSync — Destructive file system operation in plugins/codex/scripts/app-server-broker.mjs
- process.env — Environment variable access in plugins/codex/scripts/app-server-broker.mjs
- process.env — Environment variable access in plugins/codex/scripts/app-server-child.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Run Codex and Cursor as background workers inside Claude Code. Reviews, tasks, and rescues with tracked jobs, live progress, and session handoffs.
agent-collab
Delegate work from Claude Code to other AI coding agents.
Run Codex and Cursor as background workers inside Claude Code — reviews, tasks, and rescues with tracked jobs, live progress, and session handoffs.
Quick start •
Codex plugin •
Cursor plugin •
How it works •
Development •
License
One marketplace, two plugins:
| Plugin | Delegates to | Highlights |
|---|---|---|
codex |
OpenAI Codex (codex CLI) |
/codex:review, /codex:adversarial-review, /codex:rescue, session transfer, optional stop-review gate. Community fork of openai/codex-plugin-cc with Windows fixes. |
cursor |
Cursor (cursor-agent CLI) |
/cursor:review, /cursor:task, ownership-verified cancel, WSL support on Windows, resolved-model + token-usage recording. |
Both share the same job chassis: background jobs with progress-aware status, stored result output, model recording, resume handoffs into the native tool, and cancel that never kills a process it can't prove it owns.
Quick start
Add the marketplace in Claude Code:
/plugin marketplace add zebbern/agent-collab
Install one or both plugins:
/plugin install codex@agent-collab
/plugin install cursor@agent-collab
Reload, then check readiness:
/reload-plugins
/codex:setup
/cursor:setup
A first run that shows the whole loop:
/codex:review --background
/codex:status
/codex:result
For the official OpenAI plugin instead of this fork, use
/plugin marketplace add openai/codex-plugin-cc.
Codex plugin
What this fork changes (see the changelog for detail)[!IMPORTANT]
This is an unofficial fork. It is not built, endorsed, or supported by OpenAI. It is a modified version of openai/codex-plugin-cc at v1.0.6, maintained by @zebbern. Report issues here, not to OpenAI.
- Windows correctness: the broker ownership registry works on win32 (POSIX permission checks gated off), registry lock contention handles Windows
EPERMrename semantics,taskkill/tasklistbypass MSYS argument mangling, and the test suite passes on Windows (upstream fails 9 of its own tests there). - Durability:
state.jsonis written atomically under an exclusive lock; corrupt state/job files are quarantined and rebuilt; terminal jobs can never be resurrected by racing writers. - Observability:
/codex:statusis progress-aware (file changes, command executions, token usage,likely deaddetection); jobs record the model and reasoning effort they ran with; degraded transport is explicit and loud. - Quality of life:
/codex:help, richer/codex:resultwithcodex resume <session-id>handoff, stale-CLI detection in/codex:setup, stderr noise collapsing.
Requirements: Codex CLI (npm install -g @openai/codex) with a ChatGPT subscription or OpenAI API key, Node.js ≥ 18.18.
Commands
| Command | What it does |
|---|---|
/codex:review |
Read-only review of your working tree or branch (--base <ref>, --background) |
/codex:adversarial-review |
Steerable challenge review — takes focus text, questions design decisions |
/codex:rescue |
Hand a task to Codex (--model, --effort, --resume, --background) |
/codex:transfer |
Turn the current Claude session into a resumable Codex thread |
/codex:status / /codex:result / /codex:cancel |
Track, read, and stop background jobs |
/codex:setup |
Readiness check, install help, and the optional review gate |
/codex:doctor |
Read-only health report: CLI, auth, broker residue, and job-state hygiene |
/codex:help |
Full CLI usage |
/codex:review
Same review quality as running /review inside Codex directly. Use --base <ref> for branch review; --wait / --background control blocking. Read-only.
/codex:review
/codex:review --base main
/codex:review --background
/codex:adversarial-review
Pressure-tests assumptions, tradeoffs, failure modes, and alternatives. It uses the same review target selection as /codex:review (including --base <ref>), plus free-form focus text:
/codex:adversarial-review --base main challenge whether this was the right caching and retry design
/codex:adversarial-review --background look for race conditions and question the chosen approach
/codex:rescue
Delegates investigation or fixes through the codex:codex-rescue subagent — investigate a bug, try a fix, continue a previous Codex task, or take a cheaper pass with a smaller model:
/codex:rescue investigate why the tests started failing
/codex:rescue --resume apply the top fix from the last run
/codex:rescue --model spark fix the issue quickly
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky test
You can also just ask: "Ask Codex to redesign the database connection to be more resilient."
Notes:
- if you do not pass
--modelor--effort, Codex chooses its own defaults. - if you say
spark, the plugin maps that togpt-5.3-codex-spark - follow-up rescue requests can continue the latest Codex task in the repo
/codex:transfer
Creates a persistent Codex thread from the current Claude Code session and prints codex resume <session-id>. The SessionStart hook supplies the transcript path automatically; --source <path> overrides it (must live under ~/.claude/projects).
/codex:status
Shows running and recent Codex jobs for the current repository — progress on background work, the latest completed job, and whether a task is still running.
/codex:status
/codex:status task-abc123
/codex:result
Shows the final stored output for a finished job, including the Codex session ID so you can reopen the run with codex resume <session-id>.
/codex:result
/codex:result task-abc123
/codex:cancel
Cancels an active background Codex job.
/codex:cancel
/codex:cancel task-abc123
/codex:setup
Checks whether Codex is installed and authenticated. If Codex is missing and npm is available, it can offer to install Codex for you. If Codex is installed but not logged in yet, run:
!codex login
Review gate (optional, off by default)
/codex:setup --enable-review-gate
/codex:setup --disable-review-gate
When enabled, a Stop hook runs a targeted Codex review of Claude's response and blocks the stop if it finds issues.
[!WARNING]
The review gate can create a long-running Claude/Codex loop and drain usage limits quickly. Enable it only when actively monitoring the session.
Configuration
The plugin uses your local codex binary and its configuration: user-level ~/.codex/config.toml, with project-level .codex/config.toml overrides for trusted projects. For example:
model = "gpt-5.4-mini"
model_reasoning_effort = "high"
Jobs record the model (and effort) they ran with — visible in /codex:status and /codex:result.
Cursor plugin
Drives Cursor's headless cursor-agent CLI. Every job is a single tracked cursor-agent process — no shared runtime.
Requirements: cursor-agent (curl https://cursor.com/install -fsS | bash) signed in via cursor-agent login, and a Cursor subscription.
[!NOTE]
Windows: Cursor ships no native Windows CLI build. The plugin runscursor-agentthrough WSL automatically — install it inside your distro with the same command. Workspace paths are translated (C:\…→/mnt/c/…) and the Linux-side agent is tracked and reaped on cancel.
Commands
| Command | What it does |
|---|---|
/cursor:review |
Read-only review of your working tree or branch (--base <ref>, --background) |
/cursor:adversarial-review |
Steerable challenge review with focus text |
/cursor:task |
Delegate a task (--model, --resume <chat-id>, --write, --background) |
/cursor:rescue |
Hand a problem to the cursor:cursor-rescue subagent — investigate, fix, or continue with --resume <chat-id> |
/cursor:status / /cursor:result / /cursor:cancel |
Track, read, and stop background jobs |
/cursor:setup |
Readiness check with per-platform install guidance |
/cursor:doctor |
Read-only health report: CLI, auth, and job-state hygiene |
/cursor:help |
Full CLI usage |
Models
Cursor defaults to auto (its server-side router). Pin one per invocation with --model:
/cursor:review --model claude-opus-5-thinking-high
/cursor:task --model gpt-5.3-codex fix the failing test
cursor-agent --list-models shows the current roster. Jobs record the resolved model, token usage, and reasoning summaries from the stream.
Safety model
- Reviews run read-only; write mode is opt-in per task (
--write). - Cancel proves ownership before killing anything: workers persist a process identity at start (Unix start-time identity, or
(pid, CreationDate)on Windows), a stale or reused PID is never killed, and a job with no recorded proof fails closed ascleanup-pending. - On WSL, cancel reaps the Linux-side agent inside the distro first (verifying
/proccmdline before signalling, TERM→KILL), becausetaskkillcannot terminatewsl.exerelay processes — then confirms the worker's exit by identity, not PID liveness.
How it works
Both plugins share a hardened job chassis:
- Background jobs — spawn, track, and detach; jobs survive the Claude session that started them.
- Progress-aware status — live phase, file-change/command/token telemetry, last-activity signals, and
likely deaddetection for stalled jobs. - Stored results —
resultrenders the final output with files changed, reasoning summaries, the model that produced it, and a resume command (codex resume <id>/cursor-agent --resume <id>) to continue in the native tool. - Race-safe state — an exclusive lock plus a terminal-status merge guard make it impossible for a racing progress write to resurrect a cancelled job.
Development
npm ci
npm test # node --test tests/*.test.mjs
npm run build # regenerates app-server types + tsc checkJs
- CI runs the full suite on
ubuntu-latestandwindows-latestfor every push and PR (~300 tests). Tests never require a real Codex/Cursor login — fake fixtures onPATHstand in for both CLIs. - Layout:
plugins/codexandplugins/cursorare self-contained Claude Code plugins;tests/covers both;.claude-plugin/marketplace.jsonis the marketplace manifest. - Windows contributors: everything works from Git Bash; npm scripts are shell-agnostic.
License & attribution
Apache-2.0. The codex plugin is a modified version of openai/codex-plugin-cc (© 2026 OpenAI, Apache-2.0) — see NOTICE and the per-plugin changelogs for the modification history. The cursor plugin is original to this repository. Not affiliated with, endorsed by, or supported by OpenAI or Cursor (Anysphere).
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi