gastown-helper

Setup scripts, tools, and docs for Gas Town.

Contents

Path	Description
setup-town.sh	Bootstrap a Gas Town instance on fresh Ubuntu/Debian
telegram-bot/	Telegram bot for mobile Gas Town control
install-tmux.sh	All-in-one tmux installer (curl|bash)
tmux.conf	Reference template (real config is generated by installer)
docs/	Guides and reference docs

Tmux Status Bar

Single command to install (or update):

curl -fsSL https://raw.githubusercontent.com/erkantaylan/gastown-helper/master/install-tmux.sh | bash

The installer:

1. Asks 4 questions (mayor name, user/folder display, Telegram, second bar)
2. Writes runtime scripts to ~/.local/share/gt-tmux/
3. Generates a tailored ~/.config/tmux/tmux.conf
4. Reloads tmux if running

To update: run the same command. It detects your existing config and offers to keep settings.

Everything is embedded in the single script — no separate downloads needed.

See docs/tmux-statusbar.md for details on the status bar layout.

Setup Script

One-Liner

curl -fsSL https://raw.githubusercontent.com/erkantaylan/gastown-helper/master/setup-town.sh | sudo bash

Quick Start

git clone https://github.com/erkantaylan/gastown-helper.git
cd gastown-helper
sudo ./setup-town.sh

What It Does

1. Creates a new OS user with home directory and docker group
2. Installs dependencies — git, tmux, curl, jq
3. Installs Gas Town binaries (gt and bd) — from latest GitHub release or built from source
4. Configures PATH and gts alias in .bashrc
5. Runs install-tmux.sh interactively for tmux status bar setup
6. Optionally installs Claude Code, GitHub CLI (gh), and migrates SSH keys from the invoking user

Options

Flag	Description
--dry-run	Show what would happen without making changes
-h, --help	Show usage information

Telegram Bot

Mobile interface to Gas Town — send instructions, check status, talk to agents from your phone.

See telegram-bot/README.md for setup.

Quick overview:

• Just type a message -> it goes to the mayor as mail + nudge
• /status -> town overview with agents, rigs, crew
• /crew bender <msg> -> talk directly to a crew member
• /version -> Gas Town version
• Agents reply back to Telegram with gt-telegram "message"

Docs

Doc	Description
tmux-statusbar.md	Status bar layout and customization
tmux-second-status-line.md	Second status line details (rig overview)
CLAUDE.md	Agent-friendly quick reference
dev-sandbox-setup.md	Run Gas Town from source in isolation

Requirements

• Ubuntu or Debian Linux
• Root access for setup script
• Go 1.21+ for building the Telegram bot