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

# Code editor, terminal, and IDE features

> Agentastic provides a full native macOS IDE: a code editor with LSP support, a GPU-accelerated terminal, Git integration, and multi-worktree navigation.

Agentastic is a complete development environment, not just an AI launcher. It includes a native macOS code editor with syntax highlighting and LSP support, a GPU-accelerated terminal with multiple backends, built-in Git integration, and a project Navigator — all designed to work seamlessly with AI agent workflows.

## Editor

### Opening files

| Method                    | Action                                          |
| ------------------------- | ----------------------------------------------- |
| Single-click in Navigator | Preview the file (closes when you open another) |
| Double-click in Navigator | Open in a permanent tab                         |
| `Cmd+P`                   | Quick Open — search by name, symbol, or line    |
| Drag from Finder          | Drop a file into the editor area                |

### Tab management

| Action            | Shortcut      |
| ----------------- | ------------- |
| Next tab          | `Cmd+}`       |
| Previous tab      | `Cmd+{`       |
| Close tab         | `Cmd+W`       |
| Reopen closed tab | `Cmd+Shift+T` |

### Split views

Work on multiple files side by side:

* Drag a tab to the left or right edge of the editor to create a split.
* Right-click any tab and select **Split Right** or **Split Down**.

### Quick Open

Press `Cmd+P` to open Quick Open. It supports several modes depending on what you type:

| Mode                  | Prefix          | Example        |
| --------------------- | --------------- | -------------- |
| File search           | (none)          | `AppDelegate`  |
| Symbol search         | `@`             | `@viewDidLoad` |
| Go to line            | `:`             | `:42`          |
| File at specific line | `filename:line` | `App.swift:50` |

### Editing shortcuts

| Action                   | Shortcut      |
| ------------------------ | ------------- |
| Move line up             | `Option+Up`   |
| Move line down           | `Option+Down` |
| Duplicate line           | `Cmd+D`       |
| Delete line              | `Cmd+Shift+K` |
| Comment / uncomment line | `Cmd+/`       |

## Terminal

Agentastic includes an integrated terminal with two backend options. Switch between them in **Settings > Terminal**.

### Ghostty (recommended)

A GPU-accelerated terminal renderer using Metal. Ghostty delivers:

* Smooth scrolling and fast text rendering
* Native macOS look and feel
* Excellent performance for output-heavy agent sessions

### SwiftTerm

A pure Swift terminal implementation used as a reliable fallback:

* Good compatibility across all systems
* Solid alternative when Ghostty is unavailable

### Terminal features

* **Multiple tabs** — add tabs with the `+` button or `Cmd+T`.
* **Shell integration** — tab titles update to show the current directory.
* **Option as Meta** — use the Option key as Meta in Vim and Emacs.
* **Theme integration** — terminal colors follow your editor theme.

### Agent terminals

Each agent (worktree) has its own set of terminal tabs:

* Switching to a different worktree switches its terminal tabs into view.
* Terminal state (history, running processes) persists per agent.
* New terminal tabs open in the agent's working directory automatically.

### Container terminals

For agents running in Docker containers, terminal commands execute inside the container:

* Working directory is `/workspace` (where your worktree is mounted).
* Your shell configuration is available inside the container.

## Navigator

The left sidebar gives you access to your project's files and tools.

### Navigator tabs

| Tab            | Shortcut | Purpose             |
| -------------- | -------- | ------------------- |
| Files          | `Cmd+1`  | Project file tree   |
| Search         | `Cmd+2`  | Find in project     |
| Source Control | `Cmd+3`  | Git changes         |
| Agents         | `Cmd+4`  | Worktree management |

### File operations

| Action           | How                                         |
| ---------------- | ------------------------------------------- |
| New file         | `Cmd+N`                                     |
| New folder       | Right-click > **New Folder**                |
| Rename           | Select file, press `Enter`                  |
| Delete           | Press `Delete`, or right-click > **Delete** |
| Reveal in Finder | Right-click > **Show in Finder**            |

## Utility area

The bottom panel holds the terminal and other tools.

| Action              | Shortcut    |
| ------------------- | ----------- |
| Toggle utility area | `Cmd+J`     |
| New terminal tab    | `Cmd+T`     |
| Focus terminal      | \`Ctrl+\`\` |

## Inspector

The right sidebar shows file information and history.

| Action           | Shortcut     |
| ---------------- | ------------ |
| Toggle Inspector | `Cmd+Ctrl+I` |

## Command Palette

Press `Cmd+Shift+P` to open the Command Palette. Type to filter the available commands, then press `Enter` to execute. Keyboard shortcuts for each command are shown inline.

## Search

### Find in file

| Action           | Shortcut       |
| ---------------- | -------------- |
| Open find bar    | `Cmd+F`        |
| Find next        | `Cmd+G`        |
| Find previous    | `Cmd+Shift+G`  |
| Find and replace | `Cmd+Option+F` |

### Find in project

| Action                  | Shortcut      |
| ----------------------- | ------------- |
| Search across all files | `Cmd+Shift+F` |

Configure ignore patterns for project search in **Settings**.

## Language support

Agentastic supports 100+ programming languages with:

* **Syntax highlighting** — powered by Tree-sitter for accurate, fast highlighting.
* **LSP support** — connect language servers for intelligent editing features.
* **Auto-detection** — language mode is set automatically based on file extension.

### Configuring LSP

<Steps>
  <Step title="Install a language server">
    Install the language server for your language. For example:

    ```bash theme={null}
    npm install -g typescript-language-server
    ```
  </Step>

  <Step title="Open Settings > Languages">
    Use `Cmd+,` to open Settings, then go to the Languages section.
  </Step>

  <Step title="Add the server path">
    Enter the path to the language server executable for your language.
  </Step>
</Steps>

Once configured, you get:

* Code completion
* Go to definition
* Find all references
* Inline errors and warnings

## Source control

Agentastic has built-in Git integration accessible from the Source Control Navigator (`Cmd+3`):

* **Status view** — see all modified, added, and deleted files.
* **Stage / unstage** — click the `+` or `-` buttons next to each file.
* **Commit** — enter a commit message and commit directly from the panel.
* **Push / Pull** — sync your branch with the remote.
* **Branch switching** — use the branch dropdown or the Command Palette.

## Settings

Open Settings with `Cmd+,`.

### Editor settings

* Font family and size
* Tab width
* Word wrap
* Line height

### Terminal settings

* Backend (Ghostty or SwiftTerm)
* Shell selection
* Font and size
* Cursor style

### Theme

* Editor color theme
* Option to match the system dark/light mode automatically

For detailed configuration options, see [Customization](/guides/customization).