| name | stack-ops |
| description | Manage the Trinity AGI Docker Compose stack — start, stop, logs, rebuild frontend, and full deploy. |
| license | MIT |
| metadata | {"audience":"developers","workflow":"trinity"} |
What This Skill Covers
Docker Compose lifecycle operations for the Trinity AGI stack running from src/docker-compose.yml.
Start Stack
docker compose -f src/docker-compose.yml up -d
Check service status after starting.
Stop Stack
docker compose -f src/docker-compose.yml down
View Logs
All services:
docker compose -f src/docker-compose.yml logs --tail 50
Single service (e.g. OpenClaw gateway):
docker compose -f src/docker-compose.yml logs openclaw-gateway --tail 100
Summarize errors, warnings, or notable events. If there are connection issues or crash loops, suggest fixes.
Rebuild Frontend Only
When Flutter/Dart source changes need to be deployed without touching backend services.
CRITICAL: run --rm frontend-builder alone does NOT rebuild the image — it reuses the cached one. You MUST build --no-cache first.
docker compose -f src/docker-compose.yml --profile build build --no-cache frontend-builder
docker compose -f src/docker-compose.yml --profile build run --rm frontend-builder
docker restart trinity-nginx
Remind the user to hard-refresh the browser (Ctrl+Shift+R).
Full Deploy
Complete rebuild of frontend + backend after source changes across multiple services.
docker compose -f src/docker-compose.yml --profile build build --no-cache frontend-builder
docker compose -f src/docker-compose.yml --profile build run --rm frontend-builder
docker compose -f src/docker-compose.yml build --no-cache terminal-proxy auth-service
docker compose -f src/docker-compose.yml up -d terminal-proxy auth-service
docker restart trinity-nginx
docker cp src/AGENTS.md trinity-openclaw:/home/node/.openclaw/workspace/AGENTS.md
docker compose -f src/docker-compose.yml ps --format "table {{.Name}}\t{{.Status}}"
Remind user to Ctrl+Shift+R in the browser.
Service Health Check
docker compose -f src/docker-compose.yml ps --format "table {{.Name}}\t{{.Status}}"
Quick Reference
| Action | Command |
|---|
| Start | docker compose -f src/docker-compose.yml up -d |
| Stop | docker compose -f src/docker-compose.yml down |
| Logs (all) | docker compose -f src/docker-compose.yml logs --tail 50 |
| Logs (one) | docker compose -f src/docker-compose.yml logs <service> --tail 100 |
| Status | docker compose -f src/docker-compose.yml ps |
| Rebuild frontend | Build --no-cache → run builder → restart nginx |
| Full deploy | Build frontend + backend → restart all → sync AGENTS.md |