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:
- Keeping an active town session open during development
- Maintaining a persistent connection for debugging
- 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
| Option | Short | Description |
|---|---|---|
--town <PATH> | -t | Town directory (default: .) |
--verbose | -v | Enable 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 initprovisions the town and connects as neededtt spawnconnects and stays alivett statusconnects temporarily
Use tt start when you want to:
- Keep a town session open without spawning agents
- Debug connection issues
- Manually control the town lifecycle