DocsConfiguration

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:

code

/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:

code

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#

bash

npm install -g typescript-language-server

Then configure the path in Settings.

Example: Python#

bash

pip install python-lsp-server

Setup Scripts#

Customize agent initialization with setup scripts.

Worktree Setup#

Create .agentastic/setup.sh in your repository:

bash

#!/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
Greptile

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:

bash

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#

bash

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:

bash

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