gastown

# gastown - Gas Town Status & Utility Skill

Monitor and manage Gas Town polecats and convoys.

> **For autonomous epic execution, use `/crank` instead.**
> This skill is for status checks, debugging, and utility operations.

## Overview

**What this skill does:** Provides visibility into Gas Town operations and utility commands for managing workers.

| User Says | Claude Does |
|-----------|-------------|
| "what's the status?" | `gt convoy list`, `gt polecat list` |
| "check convoy X" | `gt convoy status <id>` |
| "something's stuck" | Peek into polecat, diagnose |
| "nudge that polecat" | Send continue signal |
| "cleanup finished work" | `gt polecat gc`, cleanup branches |

**For dispatching work:** Use `gt sling` (single issue) or `/crank` (autonomous epic execution with parallel waves).

---

## Operations

### 1. Status Check

Get overview of active work:

```bash
# All active convoys (dashboard view)
gt convoy list

# Specific convoy progress
gt convoy status <convoy-id>

# Polecats in a rig
gt polecat list <rig>

# All polecats across town
gt polecat list
```

### 2. Peek into Polecats

See what a polecat is doing (without returning output to your context):

```bash
# View last N lines of polecat session
tmux capture-pane -t gt-<rig>-<polecat> -p | tail -20

# Full session dump (use sparingly - large output)
tmux capture-pane -t gt-<rig>-<polecat> -p -S -

# Check if polecat is responding
gt polecat status <rig>/<polecat>
```

**Common patterns to look for:**
- "You've hit your limit" - needs `/login` reset
- Stuck on confirmation - may need nudge
- Error messages - may need intervention

### 3. Nudge Stuck Polecats

Send a message to a polecat that seems stuck:

```bash
# Send continue signal
tmux send-keys -t gt-<rig>-<polecat> "continue with your task" Enter

# More specific nudge
tmux send-keys -t gt-<rig>-<polecat> "focus on completing the current issue" Enter
```

### 4. Cleanup Operations (Simplified in v0.2.5+)

**Self-cleaning polecats (v0.2.5+):**