Customization
Customize Agentastic to fit your workflow
Overview
Agentastic offers extensive customization options for the editor, terminal, themes, and agent workflows. Access all settings with Cmd+,.
Editor Settings
Font
| Setting | Description | Default |
|---|---|---|
| Font | Editor font face | SF Mono |
| Font Size | Text size in points | 13 |
| Line Height | Line spacing multiplier | 1.5 |
Choose a monospace font that works for you. Popular options:
- SF Mono (default)
- JetBrains Mono
- Fira Code
- Menlo
Indentation
| Setting | Description | Default |
|---|---|---|
| Tab Width | Spaces per tab | 4 |
| Insert Spaces | Use spaces instead of tabs | On |
Display
| Setting | Description | Default |
|---|---|---|
| Word Wrap | Wrap long lines | On |
| Show Jump Bar | Breadcrumb navigation | On |
| Focus Dimming | Dim unfocused panes | Off |
Terminal Settings
Backend
Choose your terminal emulator:
| Backend | Description |
|---|---|
| Ghostty | GPU-accelerated (recommended) |
| SwiftTerm | Pure Swift fallback |
Ghostty provides better performance on most systems.
Shell
| Option | Description |
|---|---|
| System Default | Use your default shell |
| Bash | Force bash |
| Zsh | Force zsh |
| Custom | Specify a path |
For custom shells:
/opt/homebrew/bin/fish
/usr/local/bin/nu
Terminal Appearance
| Setting | Description | 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 |
Enable Option as Meta for vim/emacs workflows.
Theme
Editor Theme
Choose from available themes in Settings > Theme.
System Integration
| Setting | Description | Default |
|---|---|---|
| Match System | Follow system dark/light mode | On |
| Use Theme Background | Apply theme colors to editor background | On |
Agent Settings
Worktree Location
Where new worktrees are created:
| Location | Path Pattern |
|---|---|
| Inside Repo | repo/.worktree/branch |
| Adjacent | repo-worktrees/branch |
| Global | ~/worktrees/repo/branch |
Container Settings
| Setting | Description | Default |
|---|---|---|
| Mount Git Config | Share ~/.gitconfig | On |
| Mount SSH Keys | Share ~/.ssh/ | Off |
| Copy Shell Config | Copy shell configs | On |
| Network Mode | Container network access | Bridge |
Container Images
Add custom Docker images:
- Go to Settings > Agents
- Click Add Image
- Enter image name (e.g.,
myregistry/myimage:tag)
Search Settings
| Setting | Description | Default |
|---|---|---|
| Ignore Patterns | Files/folders to exclude | node_modules, .git |
| Search Limit | Maximum results | 1000 |
Configuring Ignore Patterns
Add patterns for files you never want to search:
node_modules
.git
dist
build
*.min.js
Keyboard Shortcuts
Customize any shortcut in Settings > Keybindings.
See Keyboard Shortcuts for the full list.
Language Server Protocol (LSP)
Adding a Language Server
- Install the language server
- Go to Settings > Languages
- Add the server path for your language
Example: TypeScript
npm install -g typescript-language-server
Then configure the path in Settings.
Example: Python
pip install python-lsp-server
Setup Scripts
Customize agent initialization with setup scripts.
Worktree Setup
Create .agentastic/setup.sh in your repository:
#!/bin/bash npm install cp .env.example .env
Container Setup
Edit ~/.config/agentastic/container-setup.sh for custom container configuration.
See Setup & Teardown Scripts for details.
Code Review Agents
Built-in Agents
Enable/disable in Settings > Code Review:
- Claude Code
- Codex
- CodeRabbit
Custom Review Agents
Add your own review commands:
- Go to Settings > Code Review
- Click Add Agent
- Enter name and command
Example for a local LLM:
ollama run codellama "$(cat 'prompt_file')"
File Associations
Agentastic auto-detects file types by extension. Override detection for specific files using the language selector in the status bar.
Window Behavior
Multiple Windows
- Cmd+N opens a new window
- Hold Option when opening a project to open in new window
Window Restoration
Agentastic restores your windows and tabs on restart.
Data Locations
| Data | Location |
|---|---|
| Settings | ~/Library/Application Support/Agentastic/ |
| Container Homes | ~/.agentastic/container-homes/ |
| Container Setup Script | ~/.config/agentastic/container-setup.sh |
Resetting to Defaults
rm -rf ~/Library/Application\ Support/Agentastic
Restart Agentastic for fresh defaults.
Tips
Start with Defaults
Use default settings initially. Customize as you discover preferences.
Sync Settings
Back up your settings folder for use across machines:
cp -r ~/Library/Application\ Support/Agentastic ~/Dropbox/agentastic-settings
Performance Tuning
For large projects:
- Add build folders to ignore patterns
- Disable unused language servers
- Use Ghostty terminal backend
Accessibility
- Increase font size for readability
- Enable high contrast themes
- Customize keyboard shortcuts for accessibility