Skip to main content
Agentastic is designed to fit the way you work, not the other way around. You can customize almost every aspect of the environment — from font size and indentation to which terminal backend powers your shell, to how containers are configured and how agents initialize new worktrees. Open Settings at any time with Cmd+, to get started.

​
Editor settings

​
Font

Choose any monospace font installed on your system. Popular options include:
  • SF Mono (default)
  • JetBrains Mono
  • Fira Code
  • Menlo

​
Indentation

​
Display

​
Terminal settings

​
Backend

Choose your terminal emulator in Settings > Terminal: Ghostty provides better performance on most systems and is the default for new installations.

​
Shell

For shells not listed, use the Custom option and enter the path:

​
Terminal appearance

Enable Option as Meta if you use vim or emacs key bindings in your terminal.

​
Theme

Select a theme in Settings > Theme. Agentastic includes both light and dark themes. When Match System is on, the theme switches automatically when you change your macOS appearance setting.

​
Agent settings

​
Worktree location

Control where Agentastic creates new worktrees when agents start: Choose Adjacent or Global if you want worktrees outside your repository directory, which can be useful for tools that watch the entire repo folder.

​
Container settings

​
Custom container images

To use a Docker image from your own registry:
  1. Go to Settings > Agents
  2. Click Add Image
  3. Enter the image name (for example, myregistry/myimage:tag)

​
Search settings

​
Configuring ignore patterns

Add any path patterns you never want to appear in search results:
One pattern per line. Standard glob syntax applies.

​
Keyboard shortcuts

Customize any shortcut in Settings > Keybindings. Find the command you want, click its current shortcut, and press the new key combination. See Keyboard shortcuts for Agentastic for the complete list of default shortcuts.

​
Language Server Protocol (LSP)

Adding a language server enables code intelligence features — hover documentation, go-to-definition, inline diagnostics, and completions — for your language of choice.
1

Install the language server

Install the language server binary using your package manager.
2

Configure the server path

  1. Open Settings > Languages
  2. Find your language in the list
  3. Enter the full path to the language server binary

​
Setup scripts

Setup scripts run automatically when Agentastic creates a new worktree or container. Use them to install dependencies, copy environment files, and run any other initialization your project needs.

​
Worktree setup

Create .agentastic/setup.sh in your repository root:
Make it executable with chmod +x .agentastic/setup.sh.

​
Container setup

Edit ~/.config/agentastic/container-setup.sh to control how containers are configured — which paths to mount, which environment variables to inject, and which network mode to use. See Automate worktree setup with scripts for full documentation on both script types, including environment variable references and advanced examples.

​
Code review agents

​
Built-in agents

Enable or disable the built-in code review agents in Settings > Code Review:
  • Claude Code
  • Codex
  • CodeRabbit

​
Custom review agents

Add your own review command:
  1. Go to Settings > Code Review
  2. Click Add Agent
  3. Enter a name and the shell command to run
Example using a local LLM with Ollama:

​
Window behavior

  • Press Cmd+N to open a new window
  • Hold Option when opening a project to open it in a new window instead of the current one
  • Agentastic restores your windows and open tabs automatically on restart

​
Data locations

​
Resetting to defaults

To wipe all settings and start fresh, remove the settings directory and restart Agentastic:
This deletes all your customizations permanently. Back up the directory first if you want to keep a copy.

​
Tips

​
Start with defaults

Use the default settings for the first few days. Customize only the things that actively slow you down — you will discover your real preferences faster this way.

​
Sync settings across machines

Back up your settings folder to sync it across machines:

​
Performance tuning

For large projects:
  • Add build output folders (dist, build, .next) to your search ignore patterns
  • Disable language servers for languages you are not actively using
  • Use the Ghostty terminal backend for better rendering performance