Skip to main content

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

SettingDescriptionDefault
FontEditor font faceSF Mono
Font SizeText size in points13
Line HeightLine spacing multiplier1.5
Choose any monospace font installed on your system. Popular options include:
  • SF Mono (default)
  • JetBrains Mono
  • Fira Code
  • Menlo

​
Indentation

SettingDescriptionDefault
Tab WidthSpaces per tab4
Insert SpacesUse spaces instead of tabsOn

​
Display

SettingDescriptionDefault
Word WrapWrap long linesOn
Show Jump BarBreadcrumb navigation barOn
Focus DimmingDim unfocused panesOff

​
Terminal settings

​
Backend

Choose your terminal emulator in Settings > Terminal:
BackendDescription
GhosttyGPU-accelerated (recommended)
SwiftTermPure Swift fallback
Ghostty provides better performance on most systems and is the default for new installations.

​
Shell

OptionDescription
System DefaultUse your default login shell
BashForce bash
ZshForce zsh
CustomSpecify a full path
For shells not listed, use the Custom option and enter the path: 
/opt/homebrew/bin/fish
/usr/local/bin/nu

​
Terminal appearance

SettingDescriptionDefault
FontTerminal font faceSF Mono
Font SizeTerminal text size13
Cursor StyleBlock, underline, or barBlock
Cursor BlinkAnimate the cursorOn
Option as MetaUse Option key as MetaOff
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.
SettingDescriptionDefault
Match SystemFollow macOS dark/light modeOn
Use Theme BackgroundApply theme colors to editor backgroundOn
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:
LocationPath pattern
Inside Reporepo/.worktree/branch
Adjacentrepo-worktrees/branch
Global~/worktrees/repo/branch
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

SettingDescriptionDefault
Mount Git ConfigShare ~/.gitconfig with the containerOn
Mount SSH KeysShare ~/.ssh/ with the containerOff
Copy Shell ConfigCopy shell configuration filesOn
Network ModeContainer network access levelBridge

​
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

SettingDescriptionDefault
Ignore PatternsFiles and folders to exclude from searchnode_modules, .git
Search LimitMaximum number of results to return1000

​
Configuring ignore patterns

Add any path patterns you never want to appear in search results: 
node_modules
.git
dist
build
*.min.js
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.
npm install -g typescript-language-server
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: 
#!/bin/bash
npm install
cp .env.example .env
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: 
ollama run codellama "$(cat 'prompt_file')"

​
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

DataLocation
Settings~/Library/Application Support/Agentastic/
Container homes~/.agentastic/container-homes/
Container setup script~/.config/agentastic/container-setup.sh

​
Resetting to defaults

To wipe all settings and start fresh, remove the settings directory and restart Agentastic: 
rm -rf ~/Library/Application\ Support/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: 
cp -r ~/Library/Application\ Support/Agentastic ~/Dropbox/agentastic-settings

​
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