[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83426":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":15,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":10,"trendingCount":13,"starSnapshotCount":13,"syncStatus":15,"lastSyncTime":30,"discoverSource":31},83426,"Codex-Workflows","robzilla1738\u002FCodex-Workflows","robzilla1738","Workflow-as-code orchestration for Codex","https:\u002F\u002Fgithub.com\u002Frobzilla1738\u002FCodex-Workflows",null,"TypeScript",53,0,51,2,41.2,"MIT License",false,"main",true,[22,23,24,25,26,27],"codex","codex-plugin","mcp","multi-agent","typescript","workflows","2026-06-12 04:01:41","# Codex Workflows\n\n[![CI](https:\u002F\u002Fgithub.com\u002Frobzilla1738\u002FCodex-Workflows\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Frobzilla1738\u002FCodex-Workflows\u002Factions\u002Fworkflows\u002Fci.yml)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](LICENSE)\n[![Buy me a coffee](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fsupport-Buy%20me%20a%20coffee-ffdd00?logo=buymeacoffee&logoColor=000)](https:\u002F\u002Fwww.buymeacoffee.com\u002Frobcourson)\n\nCodex has subagents, skills, plugins, and MCP. `codex-workflows` connects those\npieces into a workflow-as-code runtime: durable multi-agent runs, a live\nterminal dashboard, restartable agents, saved workflow scripts, and review\ntemplates that are meant to be used on real repos.\n\nThis is not a native Codex `\u002Fworkflows` command. Codex does not expose that\nplugin API today. This project ships the closest available surface: a Codex\nplugin with an MCP server and a `cwf` terminal UI.\n\n## Install\n\nInstall it from the GitHub marketplace in this repo:\n\n```bash\ncodex plugin marketplace add robzilla1738\u002FCodex-Workflows\ncodex plugin add codex-workflows@codex-workflows\n```\n\nStart a new Codex thread after installing. Then ask:\n\n```text\nUse codex-workflows to run the bug-sweep workflow with adapter auto.\nOpen the live dashboard automatically and tell me the run id and status.\n```\n\nCodex will call the bundled MCP server. The server starts the workflow, opens\nthe live TUI in your default terminal, and returns a run id you can inspect\nfrom Codex or from the CLI.\n\n## What it includes\n\n- `bug-sweep`: bounded codebase review, adversarial verification, repro\n  planning, and synthesis.\n- `bug-sweep-deep`: larger opt-in fanout for deeper bug hunts.\n- `release-diff-review`: release-blocker review against a branch or diff.\n- `security-auth-review`: auth, permission, injection, secret, sandbox, and MCP\n  boundary review.\n- Live dashboard with phases, agent rows, token\u002Ftool\u002Ftime metrics, recent\n  worker activity, detail view, pause\u002Fresume\u002Fstop\u002Frestart\u002Fsave controls, and\n  final report path. Token totals show as pending until Codex emits usage\n  metadata; command\u002Ftool\u002Fmessage\u002Fstderr activity updates as events arrive.\n- Workflow definitions can explicitly request up to 64 concurrent workers and\n  2000 total agents.\n- Durable run state under `${CODEX_HOME:-~\u002F.codex}\u002Fcodex-workflows\u002Fprojects\u002F\u003Cproject-hash>\u002Fruns\u002F\u003Crun-id>\u002F`\n  by default, so read-only bug hunts do not dirty the target repo.\n- Project-local storage remains available with `storageScope: \"project\"` or\n  `--storage-scope project`.\n- Downstream verify, probe, and synthesize agents receive prior phase findings\n  as explicit context instead of guessing at earlier results.\n- Detached worker heartbeats let status reads and dashboards identify orphaned\n  runs when a background workflow process dies.\n- Isolated workflow script loading through QuickJS. Workflow scripts define\n  phases and agent prompts; they do not get direct filesystem, shell, network,\n  process, or Node built-in access.\n\n## Model controls\n\nYou can route models globally or by phase\u002Fagent:\n\n```text\nUse codex-workflows to run bug-sweep with adapter auto,\nmodel gpt-5.5, reasoning xhigh,\nand modelMap {\"find\":\"gpt-5.4-mini\",\"synthesize\":\"gpt-5.5\"}.\n```\n\nCaller overrides win over workflow defaults:\n\n- `model`: default worker model.\n- `reasoning`: default Codex reasoning effort.\n- `modelMap`: phase id, agent id, or `phase:agent` overrides.\n- `promptSuffix`: extra instruction appended to every worker.\n\nModel names are validated against the local `codex debug models` catalog before\nany agents launch. Short names such as `5.4-mini` are rejected with a suggestion\nlike `gpt-5.4-mini`; they are not silently rewritten.\n\nBug-finding workflows default to read-only workers unless a workflow explicitly\ndeclares otherwise.\n\n## Local development\n\n```bash\npnpm install\npnpm validate:plugin\npnpm test\npnpm cwf validate workflows\u002Fbug-sweep.workflow.js\npnpm cwf run workflows\u002Fbug-sweep.workflow.js --watch --adapter simulate\npnpm cwf run workflows\u002Fbug-sweep.workflow.js --watch --adapter auto --model gpt-5.4-mini\npnpm cwf run workflows\u002Fbug-sweep-deep.workflow.js --watch --adapter auto --model gpt-5.4-mini\n```\n\nUseful local commands:\n\n```bash\npnpm cwf workflows\npnpm cwf watch \u003Crun-id>\npnpm cwf pause \u003Crun-id>\npnpm cwf resume \u003Crun-id>\npnpm cwf stop \u003Crun-id>\npnpm cwf stop-agent \u003Crun-id> \u003Cagent-id>\npnpm cwf restart-agent \u003Crun-id> \u003Cagent-id>\npnpm cwf save \u003Crun-id> --name release-diff-review-v2\n```\n\nThe generated plugin lives at `plugins\u002Fcodex-workflows`. Do not edit the bundled\n`dist` files by hand. Change the TypeScript packages, then run:\n\n```bash\npnpm validate:plugin\n```\n\nThat builds the packages, regenerates the plugin bundle, and checks that no\nmachine-local paths leaked into the distributable plugin.\n\n## Plugin layout\n\n```text\n.agents\u002Fplugins\u002Fmarketplace.json\nplugins\u002Fcodex-workflows\u002F\n  .codex-plugin\u002Fplugin.json\n  .mcp.json\n  dist\u002F\n  skills\u002Fcodex-workflows\u002FSKILL.md\n  workflows\u002F*.workflow.js\n```\n\nThe plugin bundle is committed so users can install from GitHub without running\n`pnpm install`.\n\n## Docs\n\n- [Plugin distribution](docs\u002Fplugin-distribution.md)\n- [Architecture](docs\u002Farchitecture.md)\n- [Claude workflows parity analysis](docs\u002Fclaude-workflows-parity.md)\n\n## Support\n\nIf this saves you time, you can support the project here:\n[buymeacoffee.com\u002Frobcourson](https:\u002F\u002Fwww.buymeacoffee.com\u002Frobcourson).\n","2026-06-11 04:11:09","CREATED_QUERY"]