[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80056":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":10,"openIssues":12,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":13,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":14,"rankGlobal":8,"rankLanguage":8,"license":15,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":18,"hasPages":16,"topics":19,"createdAt":8,"pushedAt":8,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":13,"starSnapshotCount":13,"syncStatus":11,"lastSyncTime":23,"discoverSource":24},80056,"agent-orchestration-skill","ZypherHQ\u002Fagent-orchestration-skill","ZypherHQ",null,"Python",62,2,1,0,1.43,"MIT License",false,"main",true,[],"2026-06-12 02:03:57","# Agentic Orchestration Control\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"workflow-diagram.png\" alt=\"Agentic Orchestration Control workflow\" width=\"100%\" \u002F>\n\u003C\u002Fp>\n\nAgentic Orchestration Control is an explicit-only npm control room for Codex orchestration. The global npm package installs the Codex skill into `~\u002F.codex\u002Fskills`, and the `aoc` CLI manages local run ledgers, usage reports, Codex session import, and TUI\u002FGUI views.\n\n## Start In 10 Seconds\n\nInstall the published package globally. This installs both the `aoc` CLI and the Codex skill at `~\u002F.codex\u002Fskills\u002Fagent-orchestration-skill`:\n\n```bash\nnpm install -g agentic-orchestration-control\n```\n\nOpen the control room:\n\n```bash\naoc\naoc gui\n```\n\nStart an observable run:\n\n```bash\naoc init \"Fix checkout flow\"\n```\n\nUse the skill only when you want the orchestration workflow:\n\n```text\nUse $agent-orchestration-skill for this task.\n```\n\nPrompts without the exact literal `$agent-orchestration-skill` should run in normal Codex mode.\n\n## Short Commands\n\n```bash\naoc\naoc gui\naoc init \"Fix checkout flow\"\naoc sessions\naoc import\naoc current\naoc use \u003Crun_id>\naoc search \"checkout\"\naoc usage\naoc budget 12000\naoc doctor\n```\n\n`aoc` resolves the repo from `--repo`, `AOC_REPO`, the nearest git root, or the current directory when it looks like a project. It resolves the run from `--run-id`, `AOC_RUN_ID`, `.orchestration\u002Fcurrent-run`, `.orchestration\u002Fcurrent.json`, or the latest `.orchestration\u002Fruns\u002F*` state, including imported Codex sessions.\n\n## Before A Run Exists\n\n`aoc` and `aoc gui` should open even before `aoc init`. In an empty repo they show an empty state and any discoverable Codex sessions. Use `aoc import` to import local Codex rollout logs into `.orchestration\u002Fruns\u002F` without creating a native AOC run first.\n\n## AOC Runs vs Codex Sessions\n\nAn AOC run is a local orchestration ledger created by `aoc init \"task\"`. It stores state, events, dispatches, handoffs, evidence, gates, memory, and usage under `.orchestration\u002Fruns\u002F\u003Crun_id>\u002F`.\n\nAn imported Codex session comes from local Codex rollout JSONL files under `AOC_CODEX_HOME`, `CODEX_HOME`, `~\u002F.codex`, or another configured Codex home. Imported sessions are normalized into `.orchestration\u002Fruns\u002Fcodex-*\u002F` with source metadata so the TUI, GUI, sessions list, usage, and search commands can display them beside native AOC runs.\n\n## How The Skill Works\n\nThe globally installed skill is explicit-only. The root Codex thread remains the orchestrator, and spawned workers are leaf-only. The package provides subagent profiles and validators, but it does not make model calls by itself.\n\nGlobal skill layout:\n\n```text\n~\u002F.codex\u002Fskills\u002Fagent-orchestration-skill\u002F\n```\n\nOptional repo-local install layout from `aoc install .`:\n\n```text\nskills\u002Fagent-orchestration-skill\u002F\nsubagents\u002F\n.orchestration\u002Fbin\u002Faoc\nAGENTS.md\n```\n\n## TUI And GUI\n\nUse the terminal control room for quick status:\n\n```bash\naoc\naoc sessions\naoc current\n```\n\nUse the local web GUI for a browser view:\n\n```bash\naoc gui\naoc gui --once\n```\n\nThe GUI binds to localhost by default. Remote binding requires explicit opt-in and auth:\n\n```bash\nAOC_GUI_TOKEN=\"change-me\" aoc gui --host 0.0.0.0 --allow-remote --auth-token \"$AOC_GUI_TOKEN\"\n```\n\n## Usage And Budget\n\nUsage reports separate imported or recorded real token data from local estimated orchestration pressure:\n\n```bash\naoc usage\naoc budget 12000\n```\n\nEstimated pressure is not provider billing. Treat it as a local signal for prompt size, fan-out, and validation cost.\n\n## Codex Session Import\n\nImport local Codex sessions:\n\n```bash\naoc import\n```\n\nUse a fake or alternate Codex home when testing:\n\n```bash\nAOC_CODEX_HOME=\u002Ftmp\u002Ffake-codex aoc import --json\n```\n\nList and inspect imported sessions:\n\n```bash\naoc sessions\naoc use \u003Crun_id>\naoc search \"checkout\"\n```\n\n## Safety Model\n\n- The skill activates only on the exact literal `$agent-orchestration-skill`.\n- Runtime state stays in `.orchestration\u002F`.\n- Hidden `.skills`, `.agents`, and `.codex` package payloads are rejected.\n- The GUI is localhost-only unless `--allow-remote` and an auth token are provided.\n- Imported Codex sessions are local files; review `.orchestration\u002F` before sharing or committing it.\n\n## Troubleshooting\n\nIf `aoc` is not on `PATH`, use the installed repo shim:\n\n```bash\n.\u002F.orchestration\u002Fbin\u002Faoc\n```\n\nIf no sessions appear, run:\n\n```bash\naoc import --json\naoc sessions --json\n```\n\nIf the wrong repo or run is selected, be explicit:\n\n```bash\naoc --repo .\naoc use \u003Crun_id>\n```\n\n## Development And Publishing\n\n```bash\nnpm install\nnpm test\nnpm run test:npm-cli\nnpm run publish:check\nnpm pack --dry-run\nnpm run validate:production\n```\n\nMore detail lives in [docs\u002FREADME.md](docs\u002FREADME.md) and the command reference in [docs\u002FCOMMANDS.md](docs\u002FCOMMANDS.md).\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","Agentic Orchestration Control 是一个用于 Codex 编排的 npm 控制中心。其核心功能包括通过 `aoc` 命令行工具管理本地运行日志、使用报告、Codex 会话导入及提供文本或图形用户界面。项目采用 Python 编写，支持通过简单的命令如 `aoc init \"任务名\"` 启动编排工作流，并允许用户仅在需要时启用特定技能进行任务处理。适合于需要对 AI 辅助开发过程中的活动进行精细化管理和监控的场景，特别是当开发者希望将复杂的编码任务分解为更小、更易管理的部分时。MIT 许可证下开源。","2026-06-11 03:59:04","CREATED_QUERY"]