Documentation Index
Fetch the complete documentation index at: https://docs.agentastic.dev/llms.txt
Use this file to discover all available pages before exploring further.
Agentastic’s settings are organized into sections that control everything from editor appearance to agent isolation and container configuration. Open Settings with Cmd+, or from the menu bar: Agentastic > Settings.
General
| Setting | Description | Default |
|---|
| Show Jump Bar | Display breadcrumb navigation in the editor | On |
| Focus Dimming | Dim unfocused panes | Off |
Text editing
| Setting | Description | Default |
|---|
| Font | Editor font face | SF Mono |
| Font Size | Text size in points | 13 |
| Line Height | Line spacing multiplier | 1.5 |
| Tab Width | Spaces per tab | 4 |
| Insert Spaces | Use spaces instead of tabs | On |
| Word Wrap | Wrap long lines | On |
| Markdown View | Render Markdown as plain text, markdown, or split | Markdown |
Terminal
| Setting | Description | Default |
|---|
| Terminal Emulator | Ghostty or SwiftTerm | Ghostty |
| Shell | Default shell | System Default |
| Font | Terminal font face | SF Mono |
| Font Size | Terminal text size | 13 |
| Cursor Style | Block, underline, or bar | Block |
| Cursor Blink | Animate cursor | On |
| Option as Meta | Use Option as Meta key | Off |
Theme
| Setting | Description | Default |
|---|
| Editor Theme | Syntax highlighting theme | Default |
| Match System | Follow system dark/light mode | On |
Search
| Setting | Description | Default |
|---|
| Ignore Patterns | Files and folders to exclude from search | node_modules, .git |
| Search Limit | Maximum number of results | 1000 |
Keybindings
Customize keyboard shortcuts. Each command can have a custom key combination assigned. Open the Keybindings section to browse all available commands and assign or override shortcuts.
Locations
| Setting | Description |
|---|
| Default Save Location | Where new files are saved |
| Recent Projects | List of recently opened projects |
Navigation
| Setting | Description | Default |
|---|
| Show Hidden Files | Display dotfiles in the file tree | Off |
| Sort Folders First | Show folders before files | On |
Source control
| Setting | Description | Default |
|---|
| Auto Fetch | Automatically fetch from remote | Off |
| Fetch Interval | Time between auto fetches | 5 min |
Agents
View and manage agents (git worktrees) for the current repository.
| Feature | Description |
|---|
| Agent List | All agents for the current repo |
| Create Agent | Add a new agent |
| Switch Agent | Change the active agent |
| Remove Agent | Delete an agent |
Worktree settings
| Setting | Description | Default |
|---|
| Worktree Location | Where new worktrees are stored | Adjacent |
| Worktree Setup Script | Path to the setup script run when a new worktree is created | .agentastic/setup.sh |
Container settings
| Setting | Description | Default |
|---|
| Container Images | Docker images available for container mode | See defaults |
| Setup Script Path | Custom container setup script location | ~/.config/agentastic/container-setup.sh |
| Mount Git Config | Share ~/.gitconfig with containers | On |
| Mount SSH Keys | Share ~/.ssh/ with containers | Off |
| Copy Shell Config | Copy shell configuration files to the container home | On |
| Network Mode | Container network access: Bridge, Restricted, or None | Bridge |
For detailed documentation on container configuration, see Agents. Accounts
Manage connected accounts for integrations. Use this section to add or remove authentication for services your agents and workflows depend on.
Code review
| Setting | Description | Default |
|---|
| Default Agent | Preferred review agent | Claude |
| Custom Command | Command for a custom review agent | — |
| Auto Review | Automatically review on save | Off |
Developer
Advanced settings for troubleshooting Agentastic itself.
| Setting | Description |
|---|
| Debug Mode | Enable verbose debug logging in the console |
Enabling debug mode may affect performance and produce verbose output. Use it only when troubleshooting.