Villa Gastown

AI Agent Orchestration System | Gastown Framework | Region: ap-southeast-1

Quick Start Architecture Agents Commands Discord Config Git Repo

Quick Start

# Attach to Mayor (primary interface)
gt mayor attach

# Check status
gt status

# List sessions
tmux list-sessions

# View costs
gt costs

Architecture

Town Level

hq-mayor - Coordinator

hq-deacon - Watchdog

Rig: villacalculatecost3

witness - Monitor

refinery - Processor

obsidian, onyx - Polecats

Infrastructure

EC2: r7g.2xlarge (ARM)

Region: ap-southeast-1

Storage: 400GB gp3

Services

clawedbot-listener

clawedbot-web

gt-boot

Agent Sessions

SessionRolePurpose
hq-mayorMayorPrimary coordinator, MEOW workflow
hq-deaconDeaconWatchdog, health monitoring
gt-villacalculatecost3-witnessWitnessRig observer, polecat monitoring
gt-villacalculatecost3-refineryRefineryData processing
gt-villacalculatecost3-*PolecatWorker agents (obsidian, onyx)

Attach to Agent

gt mayor attach      # Mayor
tmux attach -t hq-deacon  # Deacon
tmux attach -t gt-villacalculatecost3-witness

GT Commands

CommandDescription
gt statusSystem status
gt costsLive session costs
gt mayor attachAttach to Mayor
gt nudge <target> "msg"Send message to agent
gt peek <session>View session output
gt mail inboxCheck mail
gt bd listList beads
gt feedActivity feed

Nudge Pattern (Agent-to-Agent)

# Always use gt nudge, never raw tmux send-keys
gt nudge mayor "Status update needed"
gt nudge villacalculatecost3/witness "Check polecats"
gt nudge channel:workers "New work available"

Discord Integration

BotChannelPurpose
villa-clawedbot#villa-clawedbotCursor agent communication
gastown-bot#villa-gastown-agentSystem notifications

Clawedbot Commands

# Send message to Discord
discord-clawedbot "message"

# Check received messages
discord-check

# Restart listener
tmux kill-session -t clawedbot-listener
tmux new-session -d -s clawedbot-listener \
  "python3 ~/gt/scripts/clawedbot-listener.py"

Docs: cb.gt.villamarket.ai

Configuration

Key Paths

PurposePath
Town root~/gt
Rig~/gt/villacalculatecost3
Scripts~/gt/scripts
Bin~/gt/bin
Daemon files~/gt/daemon
AWS config~/gt/aws
Discord settings~/gt/settings/discord-channels.json

Git Repository

# Clone
git clone git@github.com:villa-market/villa-gastown.git

# Or view online
https://github.com/villa-market/villa-gastown

Environment

ComponentValue
Instancei-0887b32332fa32ed9
Regionap-southeast-1
IP13.214.204.225
AWS Account914499832220

URLs

ServiceURL
Dashboardgt.villamarket.ai
Docsdocs.gt.villamarket.ai
Clawedbotcb.gt.villamarket.ai

MEOW Workflow

Mayor-Enhanced Orchestration Workflow - always start with the Mayor:

1. Tell Mayor what to build
2. Mayor analyzes & breaks down tasks
3. Convoy creation with beads
4. Agent spawning
5. Work distribution via hooks
6. Progress monitoring
7. Completion & summary

Troubleshooting

IssueSolution
Agent stuckgt nudge <agent> "status?"
Session deadgt boot or restart via deacon
Discord not workingCheck tmux attach -t clawedbot-listener
Low contextMayor will auto-compact at 10%