tt config
View or set global configuration.
Synopsis
tt config [KEY] [VALUE]
Description
Manages the global Tinytown configuration stored in ~/.tt/config.toml. This configuration applies to all towns unless overridden.
Arguments
| Argument | Description |
|---|---|
KEY | Config key to get or set (e.g., default_cli) |
VALUE | Value to set (if omitted, shows current value) |
Options
| Option | Short | Description |
|---|---|---|
--verbose | -v | Enable verbose logging |
Available Keys
| Key | Description | Values |
|---|---|---|
default_cli | Default AI CLI for agents | claude, auggie, codex, aider, gemini, copilot, cursor |
agent_clis.<name> | Custom CLI command for a named CLI | Any command string |
Examples
View All Configuration
tt config
Output:
⚙️ Global config: /Users/me/.tt/config.toml
default_cli = "claude"
[agent_clis]
my-custom = "custom-ai --mode agent"
Available CLIs: claude, auggie, codex, aider, gemini, copilot, cursor
Get a Specific Value
tt config default_cli
Output:
claude
Set Default CLI
tt config default_cli auggie
Output:
✅ Set default_cli = "auggie"
Saved to: /Users/me/.tt/config.toml
Add Custom CLI
tt config agent_clis.my-ai "my-ai-cli --flag"
Configuration Precedence
- CLI argument (
--cli) - Town config (
tinytown.toml) - Global config (
~/.tt/config.toml) - Built-in default (
claude)
Config File Format
~/.tt/config.toml:
default_cli = "claude"
[agent_clis]
my-custom = "custom-ai --mode agent"
See Also
- Custom Models — Adding custom AI CLIs
- tt init — Town-level configuration