tools-only ZERG Status — Details
Extended reference material for status display formatting, data sources, and output schemas.
Worker & Activity Display
Workers Table
───────────────────────────────────────────────────────────────────────────────
WORKERS
───────────────────────────────────────────────────────────────────────────────
┌──────────┬────────┬────────────┬─────────────┬───────────┬──────────────────┐
│ Worker │ Port │ Status │ Task │ Progress │ Tasks Done │
├──────────┼────────┼────────────┼─────────────┼───────────┼──────────────────┤
│ worker-0 │ 49152 │ 🟢 Running │ TASK-007 │ Verifying │ 3/6 │
│ worker-1 │ 49153 │ 🟢 Running │ TASK-008 │ Coding │ 2/5 │
│ worker-2 │ 49154 │ 🟡 Idle │ - │ Waiting │ 4/4 │
│ worker-3 │ 49155 │ 🔴 Failed │ TASK-009 │ Blocked │ 2/4 │
│ worker-4 │ 49156 │ 🟢 Running │ TASK-010 │ Coding │ 2/5 │
└──────────┴────────┴────────────┴─────────────┴───────────┴──────────────────┘
Recent Activity
───────────────────────────────────────────────────────────────────────────────
RECENT ACTIVITY
───────────────────────────────────────────────────────────────────────────────
{timestamp} worker-1 TASK-006 ✅ Completed (8m 23s)
{timestamp} worker-0 TASK-005 ✅ Completed (12m 47s)
{timestamp} worker-3 TASK-009 ❌ Failed: Verification timeout
{timestamp} MERGE Level 1 ✅ Merged successfully
{timestamp} worker-2 TASK-003 ✅ Completed (6m 12s)
Blocked Tasks
───────────────────────────────────────────────────────────────────────────────
BLOCKED TASKS
───────────────────────────────────────────────────────────────────────────────
TASK-009: Implement rate limiter
Worker: worker-3
Error: Verification failed after 3 retries
Last error: "RateLimiter.limit is not a function"
Action: Review implementation, fix error, run /zerg:unblock TASK-009
Estimates
───────────────────────────────────────────────────────────────────────────────
ESTIMATES
───────────────────────────────────────────────────────────────────────────────
Remaining tasks: {n}
Estimated time: {time} (at current pace)
Projected finish: {timestamp}
Data Sources — Extended
Worker Status from Docker
# Check container status
for i in $(seq 0 $((WORKERS - 1))); do
STATUS=$(docker inspect -f '{{.State.Status}}' "factory-$FEATURE-worker-$i" 2>/dev/null || echo "not found")
echo "worker-$i: $STATUS"
done
Progress from Git
# Count commits per worker branch
for i in $(seq 0 $((WORKERS - 1))); do
BRANCH="zerg/FEATURE/worker-$i"
COUNT=$(git rev-list --count "zerg/FEATURE/base..$BRANCH" 2>/dev/null || echo 0)
echo "worker-$i: $COUNT commits"
done
Activity from Progress Log
# Read recent entries from progress file
tail -20 ".gsd/specs/$FEATURE/progress.md"
Detailed View: Tasks Table
┌───────────┬────────────────────────────────────┬─────────┬──────────┬──────────┐
│ Task ID │ Title │ Level │ Status │ Worker │
├───────────┼────────────────────────────────────┼─────────┼──────────┼──────────┤
│ TASK-001 │ Create auth types │ 1 │ ✅ Done │ worker-0 │
│ TASK-002 │ Create user schema │ 1 │ ✅ Done │ worker-1 │
│ TASK-003 │ Implement auth service │ 2 │ ✅ Done │ worker-2 │
│ TASK-004 │ Create password hashing │ 2 │ ✅ Done │ worker-0 │
│ TASK-005 │ Implement session service │ 2 │ 🔄 WIP │ worker-1 │
│ TASK-006 │ Create auth routes │ 3 │ ⏳ Wait │ - │
│ TASK-007 │ Create auth middleware │ 3 │ ⏳ Wait │ - │
│ TASK-008 │ Implement rate limiter │ 3 │ ❌ Block │ worker-3 │
└───────────┴────────────────────────────────────┴─────────┴──────────┴──────────┘
Detailed View: Workers
Worker 0 (worker-0)
Container: factory-auth-worker-0
Port: 49152
Branch: factory/auth/worker-0
Status: Running
Current task: TASK-007
Tasks completed: 3
Last activity: 2m ago
Worker 1 (worker-1)
Container: factory-auth-worker-1
Port: 49153
Branch: factory/auth/worker-1
Status: Running
Current task: TASK-008
Tasks completed: 2
Last activity: 30s ago
...
Detailed View: Commits
factory/auth/worker-0:
abc1234 feat(auth): Create auth types (TASK-001)
def5678 feat(auth): Create password hashing (TASK-004)
factory/auth/worker-1:
ghi9012 feat(auth): Create user schema (TASK-002)
jkl3456 feat(auth): Implement session service (TASK-005) [WIP]
CLI Options
zerg status [OPTIONS]
Options:
-f, --feature TEXT Feature to show status for (auto-detected)
-w, --watch Continuous update mode (refresh every N seconds)
--interval INTEGER Watch interval in seconds (default: 5)
-l, --level INTEGER Filter to specific level
--json Output as JSON for scripting
Watch Mode
Enable continuous status updates:
# Watch with default 5-second refresh
zerg status --watch
# Watch with custom interval
zerg status --watch --interval 2
Output updates in-place:
Progress: ████████████████░░░░ 80% (32/40 tasks)
Level 4/5 │ Workers: 5 │ Updated: 2s ago
JSON Output Schema
{
"feature": "user-auth",
"phase": "executing",
"current_level": 3,
"paused": false,
"error": null,
"progress": {
"total": 40,
"completed": 24,
"in_progress": 5,
"failed": 1,
"blocked": 0,
"pending": 10,
"percent": 60.0
},
"levels": {
"1": {"status": "complete", "tasks": 8, "completed": 8},
"2": {"status": "complete", "tasks": 10, "completed": 10},
"3": {"status": "running", "tasks": 9, "completed": 6},
"4": {"status": "pending", "tasks": 8, "completed": 0},
"5": {"status": "pending", "tasks": 5, "completed": 0}
},
"workers": [
{
"id": 0,
"status": "running",
"port": 49152,
"current_task": "TASK-015",
"tasks_completed": 5,
"context_usage": 0.45
}
],
"recent_events": [
{"timestamp": "10:30:45", "event": "task_complete", "task_id": "TASK-014"}
],
"stats": {
"start_time": "2026-01-25T10:00:00Z",
"elapsed_minutes": 30,
"estimated_remaining_minutes": 20
}
}
Worker State Meanings
| Status | Icon | Meaning |
|---|---|---|
| running | 🟢 | Worker actively executing a task |
| idle | 🟡 | Worker waiting for task (dependencies not met) |
| verifying | 🔵 | Worker running verification command |
| stopped | ⬜ | Worker gracefully stopped |
| crashed | 🔴 | Worker exited unexpectedly |
| checkpoint | 🟠 | Worker checkpointing for context limit |
Progress Bar Legend
Progress: ████████████░░░░░░░░ 60%
│ │ │
│ │ └── Pending (░)
│ └──── In Progress (█ lighter)
└──────────────── Completed (█ solid)