pi-docker-logs

Docker log gateway for pi agents — tail complete raw logs from Docker containers using the docker CLI. Works with the wrok.in AI Factory.

For label-filtered structured logs (by agent/service), use pi-loki-gate.

Install

pi install npm:pi-docker-logs

Configuration

Add a .dockerlogs.yml to your repo root:

tail: 200

| Key | Default | Description | |-----|---------|-------------| | tail | 200 | Default number of log lines to tail |

Tools

docker_container_list

List running factory containers.

docker_container_list()

docker_worker_logs

Fetch complete logs from a factory worker container. Captures all output (console.log + structured JSON).

docker_worker_logs(worker="1")
docker_worker_logs(worker="2", tail=500, search="error")
docker_worker_logs(worker="3", since="30m")

docker_container_logs

Fetch complete logs from any Docker container.

docker_container_logs(container="ai-factory-orchestrator")
docker_container_logs(container="ai-factory-worker-1", search="exit=")
docker_container_logs(container="ai-factory-gitea", tail=100, since="1h")

Docker vs Loki Logs

| | Docker Logs | Loki | |---|---|---| | Captures | All stdout/stderr | Structured JSON only | | Per-container | ✅ | ❌ | | Label filtering | ❌ (text search) | ✅ (agent, service) | | Best for | Complete job output, console messages | Service/agent exploration, error patterns |

Requirements

• Docker CLI (docker) must be installed and on PATH
• Current user must have Docker socket access

License

MIT