代理编排控制是一个仅显式的 npm 控制室，用于 Codex 编排。全局 npm 包将 Codex 技能安装到 ~/.codex/skills，而 aoc CLI 管理本地运行账本、使用报告、Codex 会话导入和 TUI/GUI 视图。

10秒后开始

全局安装已发布的软件包。这会在~/.codex/skills/agent-orchestration-skill安装aoc的CLI和Codex技能：

打开控制室：

开始可观察的跑步：

只有在你想要调度工作流程时才使用该技能：

没有完全字面$agent-orchestration-skill的提示应以普通Codex模式运行。

简短指令

aoc 解析来自 --repo、AOC_REPO、最近的 git root，或当前目录（看起来像项目时）。它解析来自 --run-id、AOC_RUN_ID、.orchestration/current-run、.orchestration/current.json 或最新 .orchestration/runs/* 状态的代码，包括导入的 Codex 会话。

在跑线存在之前

[aoc 和 aoc gui 应该会在 [aoc init 之前就打开。在空仓库中，它们会显示空状态和任何可发现的 Codex 会话。使用 aoc import 将本地 Codex 发布日志导入 '.

Agentic Orchestration Control

Agentic Orchestration Control is an explicit-only npm control room for Codex orchestration. The global npm package installs the Codex skill into ~/.codex/skills, and the aoc CLI manages local run ledgers, usage reports, Codex session import, and TUI/GUI views.

Start In 10 Seconds

Install the published package globally. This installs both the aoc CLI and the Codex skill at ~/.codex/skills/agent-orchestration-skill:

npm install -g agentic-orchestration-control

Open the control room:

aoc
aoc gui

Start an observable run:

aoc init "Fix checkout flow"

Use the skill only when you want the orchestration workflow:

Use $agent-orchestration-skill for this task.

Prompts without the exact literal $agent-orchestration-skill should run in normal Codex mode.

Short Commands

aoc
aoc gui
aoc init "Fix checkout flow"
aoc sessions
aoc import
aoc current
aoc use 
aoc search "checkout"
aoc usage
aoc budget 12000
aoc doctor

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/current-run, .orchestration/current.json, or the latest .orchestration/runs/* state, including imported Codex sessions.

Before A Run Exists

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/runs/ without creating a native AOC run first.

AOC Runs vs Codex Sessions

An 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/runs//.

An imported Codex session comes from local Codex rollout JSONL files under AOC_CODEX_HOME, CODEX_HOME, ~/.codex, or another configured Codex home. Imported sessions are normalized into .orchestration/runs/codex-*/ with source metadata so the TUI, GUI, sessions list, usage, and search commands can display them beside native AOC runs.

How The Skill Works

The 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.

Global skill layout:

~/.codex/skills/agent-orchestration-skill/

Optional repo-local install layout from aoc install .:

skills/agent-orchestration-skill/
subagents/
.orchestration/bin/aoc
AGENTS.md

TUI And GUI

Use the terminal control room for quick status:

aoc
aoc sessions
aoc current

Use the local web GUI for a browser view:

aoc gui
aoc gui --once