Configuration

Gas Town supports multiple runtimes. Per-rig runtime settings live in settings/config.json.

{
  "runtime": {
    "provider": "codex",
    "command": "codex",
    "args": [],
    "prompt_mode": "none"
  }
}

Runtime notes

• Claude uses hooks in .claude/settings.json for mail injection and startup.
• For Codex, set project_doc_fallback_filenames = ["CLAUDE.md"] in ~/.codex/config.toml so role instructions are picked up.
• For runtimes without hooks, Gas Town sends a startup fallback after the session is ready: gt prime, plus optional gt mail check --inject for autonomous roles, and gt nudge deacon session-started.

Shell completions

# Bash
gt completion bash > /etc/bash_completion.d/gt

# Zsh
gt completion zsh > "${fpath[1]}/_gt"

# Fish
gt completion fish > ~/.config/fish/completions/gt.fish