finbarr/yolobox/yolobox-orchestrator

Yolobox Orchestrator

Use this skill for host-side orchestration of yolobox sessions.

Do not use it for questions about the current environment from inside a running box. Inside the container, use yolobox instead.

1. Start from the user's intent, then choose the smallest yolobox command or flag set that accomplishes it.

• For an ACP client, use yolobox run codex-acp or yolobox run claude-agent-acp with piped stdin/stdout. The adapters bundle compatible engines and use ACP permission modes; --no-yolo does not control them. See references/commands.md for config, authentication, and updates.

1. Check yolobox config when defaults, merged config, or flag precedence matter.

• If default_harness is set, bare yolobox launches that shortcut; use yolobox shell for an explicit shell.

1. Prefer explicit isolation and safety flags:

• --scratch for disposable or concurrent sessions that must not share /home/yolo.
• --readonly-project when the agent only needs read access to the project tree.
• --no-env-passthrough when host API/token environment variables should not enter the box automatically.
• --claude-config --no-claude-auth when host Claude settings should be synced but the persistent box must keep its own /login credentials. This still live-mounts host Claude project history read/write.
• --copilot-config to share host Copilot CLI settings, login, and session history; add --no-copilot-auth when the box must keep its own Copilot /login.
• --open-bridge only when the agent needs to open HTTP(S) URLs in the host browser.
• --docker only when the agent needs Docker access or sibling containers.

1. When you need exact command patterns or edge-case reminders, read references/commands.md.
2. If you launch a box for another agent, point it at yolobox and YOLOBOX_CONTEXT_FILE for inside-the-box introspection.
3. When discussing concurrency, distinguish isolated per-run manifests from shared persistent state: manifests are per-run, but /home/yolo and /var/cache are shared unless --scratch is used.