Configuration
Commands for configuring agent runtimes, account settings, themes, hooks, and issue integration. These settings control how Gas Town operates at the town and rig levels.
Agent Configuration
gt config agent list
List configured agent runtimes.
gt config agent list [options]
Description: Shows all configured agent runtimes and their command mappings. Gas Town supports multiple AI coding agent runtimes.
Options:
| Flag | Description |
|---|---|
--json | Output in JSON format |
Example:
gt config agent list
Sample output:
AGENT COMMAND STATUS DEFAULT
claude claude available *
gemini gemini available
codex codex not found
cursor cursor available
auggie auggie not found
amp amp not found
gt config agent get
Get a specific agent runtime configuration value.
gt config agent get <agent> [key]
Description: Without a key, shows all configuration for the specified agent runtime. With a key, shows that specific setting.
Example:
# Show all config for claude
gt config agent get claude
# Get a specific setting
gt config agent get claude model
gt config agent set
Set an agent runtime configuration value.
gt config agent set <agent> <key> <value>
Description: Configures a specific setting for an agent runtime. Use this to set command paths, model preferences, and other runtime-specific options.
Common keys:
| Key | Description | Example |
|---|---|---|
command | Command to invoke the agent | claude |
model | Preferred model | claude-opus-4-5-20251101 |
args | Additional arguments | --verbose |
timeout | Session timeout | 3600 |
max_tokens | Maximum token limit | 200000 |
Example:
# Set command for gemini
gt config agent set gemini command "gemini"
# Set model preference
gt config agent set claude model "claude-opus-4-5-20251101"
# Set custom args
gt config agent set cursor args "--no-telemetry"
gt config default-agent
Get or set the default agent runtime.
gt config default-agent [agent]
Description: Without an argument, shows the current default agent. With an argument, sets the default agent runtime used when no --agent flag is specified.
Example:
# Show default
gt config default-agent
# Output: claude
# Set default to gemini
gt config default-agent gemini
The default agent can be overridden at the rig level with gt rig config <rig> agent <runtime> or per-command with the --agent flag.
Account Management
gt account
Manage multiple Claude Code accounts for Gas Town.
gt account <subcommand>
Description: Enables switching between Claude Code accounts (e.g., personal vs work) with easy account selection per spawn or globally.
Subcommands:
| Subcommand | Description |
|---|---|
gt account list | List registered accounts |
gt account add <handle> | Add a new account |
gt account default <handle> | Set the default account |
gt account status | Show current account info |
gt account switch <handle> | Switch to a different account |
Example:
# List accounts
gt account list
# Add a new account
gt account add work
# Set default
gt account default work
# Show current status
gt account status
# Switch accounts
gt account switch personal
Appearance
gt theme
Manage tmux status bar themes for Gas Town sessions.
gt theme [name] [options]
Description: Without arguments, shows the current theme assignment for the rig. With a name, sets the active tmux status bar theme.
Options:
| Flag | Description |
|---|---|
--list, -l | List available themes |
Subcommands:
| Subcommand | Description |
|---|---|
gt theme apply | Apply theme to all running sessions in this rig |
gt theme cli | View or set CLI color scheme (dark/light/auto) |
Example:
# Show current theme
gt theme
# List available themes
gt theme --list
# Set theme
gt theme forest
# Apply to running sessions
gt theme apply
# Set CLI color scheme
gt theme cli dark
Claude Code Hooks
gt hooks
List all Claude Code hooks configured in the workspace.
gt hooks [options]
Description: Scans for .claude/settings.json files across the workspace and displays all configured Claude Code hooks, organized by type.
Options:
| Flag | Description |
|---|---|
--verbose, -v | Show hook commands |
--json | Output as JSON |
Subcommands:
| Subcommand | Description |
|---|---|
gt hooks install | Install a hook from the registry |
gt hooks list | List available hooks from the registry |
Hook types:
| Type | Description |
|---|---|
SessionStart | Runs when Claude session starts |
PreCompact | Runs before context compaction |
UserPromptSubmit | Runs before user prompt is submitted |
PreToolUse | Runs before tool execution |
PostToolUse | Runs after tool execution |
Stop | Runs when Claude session stops |
Example:
# List all hooks
gt hooks
# Show with commands
gt hooks --verbose
# JSON output
gt hooks --json
# Install from registry
gt hooks install
Status Line
gt issue
Manage current issue displayed in the tmux status line.
gt issue <subcommand>
Description: Controls which issue/bead ID is shown in the tmux status bar for the current session. Useful for quick visual identification of what you are working on.
Subcommands:
| Subcommand | Description |
|---|---|
gt issue set <bead-id> | Set the current issue (shown in tmux status line) |
gt issue show | Show the current issue |
gt issue clear | Clear the current issue from status line |
Example:
# Set the current issue
gt issue set gt-abc12
# Show current issue
gt issue show
# Clear the status line
gt issue clear
Plugin Management
gt plugin
Manage plugins that run during Deacon patrol cycles.
gt plugin <subcommand> [options]
Description: Plugins are periodic automation tasks defined by plugin.md files with TOML frontmatter. They can be installed at town level (~/gt/plugins/) or rig level (<rig>/plugins/).
Subcommands:
| Subcommand | Description |
|---|---|
gt plugin list | List all discovered plugins |
gt plugin show <name> | Show plugin details |
gt plugin run <name> | Manually trigger plugin execution |
gt plugin history <name> | Show plugin execution history |
Gate types:
| Type | Description |
|---|---|
cooldown | Run if enough time has passed (e.g., 1h) |
cron | Run on a schedule (e.g., "0 9 * * *") |
condition | Run if a check command returns exit 0 |
event | Run on events (e.g., startup) |
manual | Never auto-run, trigger explicitly |
Example:
# List all plugins
gt plugin list
# Show plugin details
gt plugin show my-plugin
# Manually run a plugin
gt plugin run my-plugin
# List as JSON
gt plugin list --json