.cursorrules

Gas Town Quick Reference for Cursor AI | Source

Rule: Follow Official Convention

Always follow Gas Town convention from the official repo. Official docs, config schema, and CLI behavior are the source of truth.

Current Setup

• Town: ~/gt
• Agent: claude (--dangerously-skip-permissions)
• Model: Claude Opus 4.5
• Rig: villacalculatecost3

Essential Commands

gt status              # Town overview
gt mayor attach        # PRIMARY INTERFACE
gt prime               # Recover context
gt agents              # List agents
gt convoy list         # Track work
gt trail               # Recent activity

Work Assignment

gt sling <bead> <target>   # Assign work (THE command)
gt hook <bead>             # Attach without action
gt handoff <bead>          # Fresh session handoff
bd ready                   # Find available work
bd show <id>               # View issue
bd close <id>              # Complete work

Agent Hierarchy

Agent	Role	Command
Mayor	Coordinator (start here)	gt mayor attach
Deacon	System watchdog	gt deacon attach
Witness	Per-rig monitor	gt witness attach
Refinery	Merge queue	gt refinery attach
Polecat	Ephemeral worker	spawned via sling
Crew	Persistent workspace	gt crew add <name>

Core Principles

Principle	Meaning
GUPP	If work is on your Hook, YOU RUN IT
MEOW	Tell Mayor → Mayor orchestrates → Track via convoy
Hooks	Git worktrees that persist work across restarts
Beads	Git-backed issues (format: gt-abc12)

Configuration

gt config agent list                    # List agents
gt config agent get claude              # Show config
gt config agent set claude "claude --dangerously-skip-permissions --model opus"
gt config default-agent <name>          # Set default

Session Completion (MANDATORY)

1. File issues for remaining work
2. Run tests/linters if code changed
3. Update issue status
4. PUSH: git pull --rebase && bd sync && git push
5. Verify: git status shows "up to date"

Recovery

gt prime              # Context recovery
gt hooks repair       # Fix broken hooks
gt mayor restart      # Restart Mayor
gt convoy refresh     # Unstick convoy

Directory Layout

~/gt/
├── mayor/           # Mayor config (town.json, rigs.json)
├── deacon/          # Deacon config
├── settings/        # config.json, escalation.json
├── .beads/          # Issues, formulas
└── villacalculatecost3/  # Rig
    ├── crew/        # Crew workspaces
    ├── witness/     # Witness config
    └── refinery/    # Refinery config

Communication

gt mail inbox              # Check mail
gt nudge <agent> <msg>     # Direct message
gt broadcast <msg>         # Message all

When in Doubt

1. Run gt status to see current state
2. Run gt prime to recover context
3. Attach to Mayor: gt mayor attach
4. Check docs: github.com/steveyegge/gastown