{"id":47524170,"url":"https://github.com/Kevin7Qi/codex-collab","last_synced_at":"2026-04-22T10:00:53.490Z","repository":{"id":341144344,"uuid":"1153559213","full_name":"Kevin7Qi/codex-collab","owner":"Kevin7Qi","description":"Collaborate with Codex from Claude Code","archived":false,"fork":false,"pushed_at":"2026-04-10T09:03:00.000Z","size":671,"stargazers_count":80,"open_issues_count":1,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-10T11:13:49.292Z","etag":null,"topics":["claude","claude-code","claude-skills","codex","skill"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kevin7Qi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-09T12:47:37.000Z","updated_at":"2026-04-06T09:59:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Kevin7Qi/codex-collab","commit_stats":null,"previous_names":["kevin7qi/codex-collab"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kevin7Qi/codex-collab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kevin7Qi%2Fcodex-collab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kevin7Qi%2Fcodex-collab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kevin7Qi%2Fcodex-collab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kevin7Qi%2Fcodex-collab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kevin7Qi","download_url":"https://codeload.github.com/Kevin7Qi/codex-collab/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kevin7Qi%2Fcodex-collab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32130776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T08:34:57.708Z","status":"ssl_error","status_checked_at":"2026-04-22T08:34:55.583Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-code","claude-skills","codex","skill"],"created_at":"2026-03-27T18:00:30.894Z","updated_at":"2026-04-22T10:00:53.484Z","avatar_url":"https://github.com/Kevin7Qi.png","language":"TypeScript","funding_links":[],"categories":["Sponsors ❤️","Other"],"sub_categories":["Community Skills"],"readme":"# codex-collab\n\n[![CI](https://github.com/Kevin7Qi/codex-collab/actions/workflows/ci.yml/badge.svg)](https://github.com/Kevin7Qi/codex-collab/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Bun](https://img.shields.io/badge/runtime-Bun-f9f1e1?logo=bun)](https://bun.sh/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-3178c6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n\n[English](README.md) | [中文](README.zh-CN.md)\n\nCollaborate with [Codex](https://github.com/openai/codex) from [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Run tasks, get code reviews, do parallel research, all without leaving your Claude session.\n\n![demo](.github/assets/demo.png)\n\ncodex-collab is a [Claude Code skill](https://docs.anthropic.com/en/docs/claude-code/skills) that drives Codex through its app server JSON-RPC protocol. It manages threads, streams structured events, handles tool-call approvals, and lets you resume conversations — all without leaving your Claude session.\n\n## Why\n\n- **Structured communication** — Talks to Codex via JSON-RPC over stdio. Every event is typed and parseable.\n- **Event-driven progress** — Streams progress lines as Codex works, so Claude sees what's happening in real time.\n- **Review automation** — One command to run code reviews for PRs, uncommitted changes, or specific commits in a read-only sandbox.\n- **Thread reuse** — Resume existing threads to send follow-up prompts, build on previous responses, or steer the work in a new direction.\n- **Approval control** — Configurable approval policies for tool calls: auto-approve, interactive, or deny.\n\n## Installation\n\nRequires [Bun](https://bun.sh/) \u003e= 1.0 and [Codex CLI](https://github.com/openai/codex) (`npm install -g @openai/codex`) on your PATH. Tested on Linux (Ubuntu 22.04), macOS, and Windows 10.\n\n```bash\ngit clone https://github.com/Kevin7Qi/codex-collab.git\ncd codex-collab\n```\n\n### Linux / macOS\n\n```bash\n./install.sh\n```\n\n### Windows\n\n```powershell\npowershell -ExecutionPolicy Bypass -File install.ps1\n```\n\nAfter installation, **reopen your terminal** so the updated PATH takes effect, then run `codex-collab health` to verify.\n\nThe installer builds a self-contained bundle, deploys it to your home directory (`~/.claude/skills/codex-collab/` on Linux/macOS, `%USERPROFILE%\\.claude\\skills\\codex-collab\\` on Windows), and adds a binary shim to your PATH. Once installed, Claude discovers the skill automatically.\n\n\u003cdetails\u003e\n\u003csummary\u003eDevelopment mode\u003c/summary\u003e\n\nUse `--dev` to symlink source files for live-reloading instead of building a bundle:\n\n```bash\n# Linux / macOS\n./install.sh --dev\n\n# Windows (may require Developer Mode or an elevated terminal for symlinks)\npowershell -ExecutionPolicy Bypass -File install.ps1 -Dev\n```\n\n\u003c/details\u003e\n\n## Quick Start\n\n```bash\n# Run a prompted task\ncodex-collab run \"what does this project do?\" -s read-only --content-only\n\n# Code review\ncodex-collab review --content-only\n\n# Resume a thread\ncodex-collab run --resume \u003cid\u003e \"now check error handling\" --content-only\n```\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `run \"prompt\" [opts]` | Start thread, send prompt, wait, print output |\n| `review [opts]` | Code review (PR, uncommitted, commit) |\n| `jobs [--json] [--all]` | List threads (`--limit \u003cn\u003e` to cap) |\n| `kill \u003cid\u003e` | Interrupt running thread |\n| `output \u003cid\u003e` | Full log for thread |\n| `progress \u003cid\u003e` | Recent activity (tail of log) |\n| `models` | List available models |\n| `health` | Check dependencies |\n\n\u003cdetails\u003e\n\u003csummary\u003eThread management\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `delete \u003cid\u003e` | Archive thread, delete local files |\n| `clean` | Delete old logs and stale mappings |\n| `approve \u003cid\u003e` | Approve a pending request |\n| `decline \u003cid\u003e` | Decline a pending request |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOptions\u003c/summary\u003e\n\n| Flag | Description |\n|------|-------------|\n| `-d, --dir \u003cpath\u003e` | Working directory |\n| `-m, --model \u003cmodel\u003e` | Model name (default: auto — latest available) |\n| `-r, --reasoning \u003clevel\u003e` | low, medium, high, xhigh (default: auto — highest for model) |\n| `-s, --sandbox \u003cmode\u003e` | read-only, workspace-write, danger-full-access (default: workspace-write; review always uses read-only) |\n| `--mode \u003cmode\u003e` | Review mode: pr, uncommitted, commit, custom |\n| `--ref \u003chash\u003e` | Commit ref for `--mode commit` |\n| `--resume \u003cid\u003e` | Resume existing thread |\n| `--approval \u003cpolicy\u003e` | Approval policy: never, on-request, on-failure, untrusted (default: never) |\n| `--content-only` | Suppress progress lines; with `output`, return only extracted content |\n| `--timeout \u003csec\u003e` | Turn timeout (default: 1200) |\n| `--base \u003cbranch\u003e` | Base branch for PR review (default: main) |\n\n\u003c/details\u003e\n\n## Defaults \u0026 Configuration\n\nBy default, codex-collab auto-selects the **latest model** (preferring `-codex` variants) and the **highest reasoning effort** supported by that model. No configuration needed — it stays current as new models are released.\n\nTo override defaults persistently, use `codex-collab config`:\n\n```bash\n# Show current config\ncodex-collab config\n\n# Set a preferred model\ncodex-collab config model gpt-5.3-codex\n\n# Set default reasoning effort\ncodex-collab config reasoning high\n\n# Unset a key (return to auto-detection)\ncodex-collab config model --unset\n\n# Unset all keys\ncodex-collab config --unset\n```\n\nAvailable keys: `model`, `reasoning`, `sandbox`, `approval`, `timeout`\n\nCLI flags always take precedence over config, and config takes precedence over auto-detection:\n\n```\nCLI flag  \u003e  config file  \u003e  auto-detected\n```\n\nConfig is stored in `~/.codex-collab/config.json`.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines. This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md) code of conduct.\n\n## See also\n\nFor simpler interactions, you can also check out the official [Codex MCP server](https://developers.openai.com/codex/guides/agents-sdk). codex-collab is designed as a Claude Code skill, with built-in support for code review, thread management, and real-time progress streaming.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKevin7Qi%2Fcodex-collab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKevin7Qi%2Fcodex-collab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKevin7Qi%2Fcodex-collab/lists"}