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

# Customize Agentastic for your workflow

> Adjust editor fonts, terminal backends, themes, agent settings, LSP configuration, and keyboard shortcuts to match the way you work.

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

| Setting     | Description             | Default |
| ----------- | ----------------------- | ------- |
| Font        | Editor font face        | SF Mono |
| Font Size   | Text size in points     | 13      |
| Line Height | Line spacing multiplier | 1.5     |

Choose any monospace font installed on your system. Popular options include:

* 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 bar | On      |
| Focus Dimming | Dim unfocused panes       | Off     |

## Terminal settings

### Backend

Choose your terminal emulator in **Settings > Terminal**:

| Backend   | Description                   |
| --------- | ----------------------------- |
| Ghostty   | GPU-accelerated (recommended) |
| SwiftTerm | Pure Swift fallback           |

Ghostty provides better performance on most systems and is the default for new installations.

### Shell

| Option         | Description                  |
| -------------- | ---------------------------- |
| System Default | Use your default login shell |
| Bash           | Force bash                   |
| Zsh            | Force zsh                    |
| Custom         | Specify 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

| 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 the cursor       | On      |
| Option as Meta | Use Option key as Meta   | Off     |

<Tip>
  Enable **Option as Meta** if you use vim or emacs key bindings in your terminal.
</Tip>

## Theme

Select a theme in **Settings > Theme**. Agentastic includes both light and dark themes.

| Setting              | Description                             | Default |
| -------------------- | --------------------------------------- | ------- |
| Match System         | Follow macOS dark/light mode            | On      |
| Use Theme Background | Apply theme colors to editor background | On      |

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:

| Location    | Path pattern              |
| ----------- | ------------------------- |
| Inside Repo | `repo/.worktree/branch`   |
| Adjacent    | `repo-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

| Setting           | Description                             | Default |
| ----------------- | --------------------------------------- | ------- |
| Mount Git Config  | Share `~/.gitconfig` with the container | On      |
| Mount SSH Keys    | Share `~/.ssh/` with the container      | Off     |
| Copy Shell Config | Copy shell configuration files          | On      |
| Network Mode      | Container network access level          | Bridge  |

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

| Setting         | Description                              | Default                |
| --------------- | ---------------------------------------- | ---------------------- |
| Ignore Patterns | Files and folders to exclude from search | `node_modules`, `.git` |
| Search Limit    | Maximum number of results to return      | 1000                   |

### 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](/guides/keyboard-shortcuts) 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.

<Steps>
  <Step title="Install the language server">
    Install the language server binary using your package manager.

    <Tabs>
      <Tab title="TypeScript">
        ```bash theme={null}
        npm install -g typescript-language-server
        ```
      </Tab>

      <Tab title="Python">
        ```bash theme={null}
        pip install python-lsp-server
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="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
  </Step>
</Steps>

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

```bash theme={null}
#!/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](/guides/setup-teardown-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:

```bash theme={null}
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

| Data                   | Location                                    |
| ---------------------- | ------------------------------------------- |
| 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:

```bash theme={null}
rm -rf ~/Library/Application\ Support/Agentastic
```

<Warning>
  This deletes all your customizations permanently. Back up the directory first if you want to keep a copy.
</Warning>

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

```bash theme={null}
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