Keyboard shortcuts

Press ← or β†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

tt start

Keep a connection open to the current town.

Synopsis

tt start [OPTIONS]

Description

Connects to an existing town and keeps the process running until Ctrl+C. This is useful for:

  1. Keeping an active town session open during development
  2. Maintaining a persistent connection for debugging
  3. Watching a town without spawning a new agent

Note: Towns automatically connect to central Redis when you run tt init or any command that needs it. This command is mainly for explicitly keeping the town connection open.

Options

OptionShortDescription
--town <PATH>-tTown directory (default: .)
--verbose-vEnable verbose logging

Examples

Keep Town Running

tt start

Output:

πŸš€ Town connection open
^C
πŸ‘‹ Closing town connection...

With Specific Town

tt start --town ~/git/my-project

When to Use

Most operations don’t require tt start because:

  • tt init provisions the town and connects as needed
  • tt spawn connects and stays alive
  • tt status connects temporarily

Use tt start when you want to:

  • Keep a town session open without spawning agents
  • Debug connection issues
  • Manually control the town lifecycle

See Also