ACP Codex Subagents

This workspace turns the idea note into a small runnable ACP/Codex orchestration layer. It uses acpx named sessions as the transport and keeps each subagent scoped by role and file ownership.

acpx is still alpha, so this is an experimental workflow. The script defaults to npx -y acpx@latest when a global acpx binary is not installed.

Quick Start

Check the local prerequisites:

./scripts/acpx-subagents doctor

Create or reuse the named Codex sessions for this workspace:

./scripts/acpx-subagents ensure

Send one task to one subagent:

./scripts/acpx-subagents send ui --no-wait "Implement the navigation fix in the owned UI files."

Send the same high-level task to all configured subagents:

./scripts/acpx-subagents parallel --no-wait -- "Review your owned area and report the smallest safe implementation plan."

Target another repository without moving this orchestration folder:

./scripts/acpx-subagents --cwd /path/to/project ensure
./scripts/acpx-subagents --cwd /path/to/project send tests --no-wait "Add focused coverage for the new parser behavior."

Agents

The default agents are defined in subagents.conf:

ui: frontend, templates, static assets, UI components
pipeline: pipeline/runtime/schema/guard logic
rules: rule packs, policy, validation rules
tests: tests, fixtures, harnesses, test docs

Every prompt sent through the script gets wrapped with the agent role, ownership boundaries, and collaboration rules. Agents are told not to edit outside their owned paths unless the task explicitly grants that scope.

Commands

./scripts/acpx-subagents doctor
./scripts/acpx-subagents ensure [agent...]
./scripts/acpx-subagents send [--no-wait] [--file prompt.md] <agent> [prompt...]
./scripts/acpx-subagents parallel [--no-wait|--wait] [agent...] -- [prompt...]
./scripts/acpx-subagents sessions
./scripts/acpx-subagents show <agent>
./scripts/acpx-subagents history <agent> [limit]
./scripts/acpx-subagents close [agent...]

Set ACPX_BIN if you want to pin a local or global command:

ACPX_BIN="acpx" ./scripts/acpx-subagents ensure
ACPX_BIN="npx -y acpx@0.1.15" ./scripts/acpx-subagents ensure

Set SUBAGENTS_CONFIG to use a different Bash config file with another agent list or different ownership scopes.

Integration Notes

acpx scopes sessions by git root when one exists. In a directory without a git repository, sessions are scoped to the exact current working directory. For real parallel implementation work, run this against the actual project repository and use separate worktrees when agents will make independent changes.

References:

Downloads last month: -; Downloads are not tracked for this model. How to track

Inference Providers NEW

This model isn't deployed by any Inference Provider. 🙋 Ask for provider support