Open Settings with Cmd+, or from the menu bar: Agentastic > Settings.
General
| Setting | Description | Default |
|---|
| Show Jump Bar | Display breadcrumb navigation in 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/folders to exclude | node_modules, .git |
| Search Limit | Maximum results | 1000 |
Keybindings
Customize keyboard shortcuts. Each command can have a custom key combination assigned.
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 | Off |
| Sort Folders First | 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 current repo |
| Create Agent | Add new agent |
| Switch Agent | Change 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 setup script for new worktrees | .agentastic/setup.sh |
Container Settings
| Setting | Description | Default |
|---|
| Container Images | Docker images available for containers | 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 configs to container home | On |
| Network Mode | Container network access (Bridge/Restricted/None) | Bridge |
See Docker Containers for detailed documentation.
Accounts
Manage connected accounts for integrations.
Code Review
| Setting | Description | Default |
|---|
| Default Agent | Preferred review agent | Claude |
| Custom Command | Command for custom agent | - |
| Auto Review | Review on save | Off |
Developer
Advanced settings for development and debugging:
| Setting | Description |
|---|
| Debug Mode | Enable debug logging |
| Inspector Tools | Show internal development tools |