# ZERG Status — Details

> Extended reference material for status display formatting, data sources, and output schemas.

- Skill: `tools-only/zerg-status-details` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/zerg-status-details`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/zerg-status-details/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/zerg-status-details

---

<!-- SPLIT: details, parent: status.md -->
# 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

```bash
# 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

```bash
# 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

```bash
# 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:

```bash
# 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

```json
{
  "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)
```