| name | agentic-ecosystem-docker |
| description | This skill should be used when containerizing a multi-service agentic ecosystem (UI + Agent Management Server, optionally launchers/ingestors) with Docker Compose while preserving localhost-only security, correct in-container networking, centralized log volume mounts, and working Codex/Claude CLIs. |
Agentic Ecosystem Docker
"""
[Created by Codex: 019b78e6-c6cb-7f72-ab5a-c16c536b8e70]
[Ported to Claude Code by Opus: 5f029f5d-392f-4e16-bf28-f45f9be1e3cb]
"""
Purpose
Provide a repeatable workflow and checklists for Dockerizing the agentic ecosystem so docker compose up --build runs the UI and AMS with working /api/agent-sdk/*, Live Logs (SSE), and agent start/stop.
When To Use
- Need to run Agent HQ (or similar Vite UI) + AMS together via Docker Compose
- Need localhost-only exposure (bind
127.0.0.1:PORT:PORT)
- Seeing
403 forbidden from /api/agent-sdk/* or SSE endpoints in Docker (loopback checks)
- Need to mount centralized logs and provider CLIs into containers
Non-Negotiable Contract
- Publish the UI port only on loopback (example:
127.0.0.1:8037:8037)
- Do not publish AMS port (use
expose, not ports)
- Bind Vite to
0.0.0.0 inside container
- Use Docker hostname for AMS from the UI (
http://ams:8041)
- Run smoke tests after each phase before continuing
Workflow
- Load
references/agentic_ecosystem_docker_playbook.md and follow phases in order.
- If a Linux Codex binary is required inside a container, run
scripts/build_codex_linux_binary.py and mount the result into AMS.
- Validate with curl-based smoke tests (HTML,
/api/agent-sdk/list, SSE endpoints, start/stop).
Bundled Resources
- Step-by-step playbook:
references/agentic_ecosystem_docker_playbook.md
- Linux Codex builder helper:
scripts/build_codex_linux_binary.py
