acpx v4.0 - Agent Orchestrator
Enhanced CLI wrapper di atas acpx dengan fitur orchestration: parallel, health check, workflows.
Quick Start
# Discover agents
acpx discover
# Health check
acpx health
# Run single agent
acpx run opencode "Fix bug"
# Run workflow
acpx workflow review
Commands
| Command | Description | Example |
|---|
discover | List installed agents | acpx discover |
health | Test all agents | acpx health |
run | Run single agent | acpx run opencode "task" |
parallel | Run agents parallel from file | acpx parallel tasks.txt |
batch | Run agents sequential from file | acpx batch tasks.txt |
watch | Watch agent status | acpx watch opencode |
kill | Kill agent sessions | acpx kill opencode |
workflow | Run preset workflow | acpx workflow review |
json | Run with JSON output | acpx json opencode "task" | jq |
exec | Direct acpx passthrough | acpx exec opencode "task" |
Workflows
| Workflow | Description |
|---|
review | Code review dengan JSON output |
refactor | Safe refactoring dengan diff |
test | Generate pytest tests |
debug | Deep investigation (600s timeout) |
Batch File Format
# tasks.txt
opencode exec 'Fix auth.py'
pi exec 'Create tests'
kimi --print --yolo --prompt 'Review changes'
acpx parallel tasks.txt # Run parallel
acpx batch tasks.txt # Run sequential
Spawn via OpenClaw
// Health check
sessions_spawn(
task="acpx health",
label="health-check",
runtime="subagent",
mode="run"
)
// Run workflow
sessions_spawn(
task="acpx workflow review",
label="review",
runtime="subagent",
mode="run"
)
// Parallel tasks
sessions_spawn(
task="acpx parallel tasks.txt",
label="parallel-jobs",
runtime="subagent",
mode="run"
)
// JSON output
sessions_spawn(
task="acpx json opencode 'List functions'",
label="json-task",
runtime="subagent",
mode="run"
)
Helper Scripts
acpx - Main orchestrator CLIacpx-batch - Legacy sequential runneracpx-workflow - Legacy workflow presetsacpx-discover - Legacy discovery
Changelog
- v4.0.0 - Enhanced orchestrator: parallel, health check, workflows, json output
- v3.1.0 - Simple CLI wrapper
- v3.0.0 - Generic auto-discovery
- v2.0.0 - Async multi-agent patterns
- v1.0.0 - Initial wrapper