---
title: IDE
description: "The Agentastic workspace — title bar, multiple repositories, editor, terminal, navigator, utility area, and Zen mode on macOS."
updated: "2026-11-15"
---

## Overview

Agentastic provides a full-featured development environment with a native macOS code editor, GPU-accelerated terminal, and integrated tooling. While optimized for AI agent workflows, it's a capable standalone editor for everyday development.

## Title Bar

The repository, branch, and worktree controls are combined into a single **breadcrumb** in the title bar — `repository › branch › worktree` — for a compact, uncluttered chrome. Click any segment to switch the active repository, branch, or worktree.

## Multiple Repositories

Open a parent folder that isn't a git repository itself but has git repositories directly inside it, and Agentastic detects them and offers to add them. An **Add Repositories** sheet lists everything it found; toggle the ones you want (or **Select All**) and confirm. Each repository you add becomes its own entry in the sidebar, with worktrees, branches, and agents managed independently.

## Editor

### Opening Files
- **Click** a file in the Navigator to preview it
- **Double-click** to open in a permanent tab
- Press <kbd>Cmd</kbd>+<kbd>P</kbd> for Quick Open
- Drag files from Finder into the editor
- Open images and PDFs in the editor; PDFs use the native Quick Look preview
- Open Markdown in Source, Document, or Split view, with [annotations you can send to an agent](/docs/features/markdown#comments-and-sending-a-passage-to-an-agent)

### Empty Editor Quick Actions

When an editor pane has no file open, it shows one-click cards so you can start without hunting through menus:

- **Agent Home** — open the launcher to start a new agent
- **New Terminal** — spin up a terminal in the current worktree
- **New File** — create and name a file
- **Browser** — open the built-in browser
- **Browse Files** — jump into the project file tree

The same actions are always available from the menus and the Command Palette (<kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>) — the cards are just a faster path from a blank pane.

### Tab Management

| Action | Shortcut |
|--------|----------|
| Show Next Tab | <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>]</kbd> |
| Show Previous Tab | <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>[</kbd> |
| Select Next / Previous Tab | <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>Right</kbd> / <kbd>Left</kbd> |
| Close Tab | <kbd>Cmd</kbd>+<kbd>W</kbd> |
| Reopen Closed Tab | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> |

### Split Views

Work on files, terminals, browsers, pull requests, and chats side by side:
- Drag any tab onto the top, bottom, left, or right edge of a pane
- Right-click a tab and choose **Split Up**, **Split Down**, **Split Left**, or **Split Right**
- Press <kbd>Cmd</kbd>+<kbd>D</kbd> to split side by side, or <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> for top and bottom

### Open in Another App

Keep Agentastic as the agent control center while using the editor, terminal, or Git client you already prefer. Right-click a repository or worktree in the **Agents** navigator, open **Open in…**, then choose any compatible app installed on your Mac.

Agentastic detects editors and IDEs such as Xcode, Cursor, Windsurf, Visual Studio Code, Zed, JetBrains IDEs, Nova, Sublime Text, and BBEdit. The same menu can open the worktree in Terminal, iTerm, Ghostty, Warp, WezTerm, GitHub Desktop, Fork, Tower, and other supported tools. Only apps that are installed appear.

### Quick Open

Press <kbd>Cmd</kbd>+<kbd>P</kbd> to open Quick Open with multiple modes:

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

### Code Editing

| Action | Shortcut |
|--------|----------|
| Move Line Up | <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>[</kbd> |
| Move Line Down | <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>]</kbd> |
| Outdent / Indent Line | <kbd>Cmd</kbd>+<kbd>[</kbd> / <kbd>Cmd</kbd>+<kbd>]</kbd> |
| Toggle Line Comment | <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>/</kbd> |
| Jump to Definition | <kbd>Cmd</kbd>+<kbd>Ctrl</kbd>+<kbd>J</kbd> |

## Terminal

Agentastic includes a powerful integrated terminal with four backend options.

### Ghostty (Recommended)

GPU-accelerated terminal using Metal for excellent performance:
- Smooth scrolling
- Fast text rendering
- Native macOS feel

### WezTerm

GPU-accelerated (OpenGL) emulator with font ligatures via HarfBuzz.

### xterm.js

WebGL-accelerated backend that runs in a WebView, with clickable URL detection and theme sync.

### SwiftTerm

Pure Swift implementation as a reliable fallback:
- Good compatibility
- Works on all systems

Web URLs in every terminal backend are clickable on a plain click (no <kbd>Cmd</kbd>) and can open in a split. Ghostty, WezTerm, and SwiftTerm also detect printed file paths; xterm.js supports explicit `file://` hyperlinks. Hold <kbd>Option</kbd> to open either kind of link as a full tab, or <kbd>Cmd</kbd> to use the external browser or macOS application. See [Terminal](/docs/features/terminal) for details and backend-specific behavior.

### Terminal Features

- **Multiple tabs** - Create tabs with the + button or <kbd>Cmd</kbd>+<kbd>T</kbd>
- **Shell integration** - Tab titles show current directory
- **Option as Meta** - Use Option key as Meta in vim/emacs
- **Theme integration** - Colors match your editor theme

### Agent Terminals

Each agent (worktree) has its own terminal tabs:
- Switching agents switches terminals
- Terminal state persists per agent
- New terminals open in the agent's directory

### Container Terminals

For container-backed agents, terminals run inside Docker:
- Commands execute in the container
- Working directory is `/workspace`
- Your shell config is available

## Navigator

The left sidebar shows your project structure.

### Navigator Tabs

| Tab | Shortcut | Purpose |
|-----|----------|---------|
| Files | <kbd>Cmd</kbd>+<kbd>1</kbd> | Project file tree |
| Search | <kbd>Cmd</kbd>+<kbd>2</kbd> | Find in project |
| Source Control | <kbd>Cmd</kbd>+<kbd>3</kbd> | Git changes |
| Agents | <kbd>Cmd</kbd>+<kbd>4</kbd> | Worktree management |
| Agent Chat | <kbd>Cmd</kbd>+<kbd>5</kbd> | [Run agents as chats](/docs/features/chat) |

### File Operations

- **New File**: <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>N</kbd>
- **New File from Clipboard**: <kbd>Cmd</kbd>+<kbd>V</kbd> — creates a file from whatever is on the clipboard, in the selected folder
- **New Folder**: Right-click > New Folder
- **Rename**: Press Enter on selected file
- **Delete**: Press Delete or right-click > Delete
- **Reveal in Finder**: Right-click > Show in Finder
- **Copy Path** / **Copy Relative Path**: Right-click, for pasting into a prompt
- **Repomix**: Right-click any selection of files and folders to pack them into one agent-ready document, opened in a new editor tab. Format, file summary, directory tree, line numbers, and ignore patterns come from **Settings > Repomix**. The ignore rules decide what goes into a folder you pick; files you pick are always packed, and so is everything inside a folder those rules would leave out. A pack holds at most 512 MB of text; a larger selection is refused, unless a token limit trims it first. The same packer is available to agents as [`dev repomix`](/docs/reference/dev-internal#repomix).

### Navigator Position

By default the navigator sits on the left. To move it to the right, open **Settings > General > Navigator Position** and choose **Right**. The navigator, editor, and inspector reorder live — panel widths, collapsed state, resize handles, the toolbar, and Zen mode all follow the new edge, and nothing is recreated when you switch. **Left** remains the default.

### Sidebar Style

Choose how the navigator is drawn in **Settings > General > Sidebar Style**:

- **Classic** keeps the sidebar flat and flush with the window edge.
- **Modern** (the default) uses the native macOS sidebar, which floats as a rounded card on macOS 26 and later.

## Utility Area

The bottom panel contains the terminal and other tools.

| Action | Shortcut |
|--------|----------|
| Toggle Utility Area | <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>J</kbd> |
| New Terminal Tab | <kbd>Cmd</kbd>+<kbd>T</kbd> |
| Focus Terminal | <kbd>Ctrl</kbd>+<kbd>`</kbd> |

While it is hidden, the editor reaches the bottom of the window and a small grabber sits centered under it. Hover the grabber to see its label and shortcut, click it to open the utility area at its last height, or drag it up to open it to the height you want. Once open, drag the area's top edge to resize it.

## Status Information

The window has no status bar; what it showed sits closer to what it describes:

| Item | Where it is |
|---|---|
| Remote host | In the toolbar, after the worktree name: the SSH host this workspace is attached to, with its connection state and a **Sessions** button for its [remote sessions](/docs/guides/remote-machines). Click the host to reconnect a dropped connection. Absent for local workspaces |
| Cloud worktree | In the toolbar, after the worktree name: the cloud mark, with the VM's state when it isn't simply running. Click it to wake a sleeping VM, or right-click it to sleep, wake, or resize the VM |
| File info and cursor position | At the trailing end of the active pane's tab bar while the utility area is hidden, and in the utility area's toolbar while it is open. File info is the byte size and the pixel dimensions of an image. Cursor position is `Line: n  Col: n`, or the line and character counts of the selection |
| Utility area toggle | The grabber under the editor, the button in the utility area's toolbar, **View > Show Utility Area**, or <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>J</kbd> |

Per-file settings — language, indentation, wrapping, Markdown view mode — live in the **File Inspector** (<kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>1</kbd>), where they have room for labels.

## Zen Mode

Zen Mode strips the window down to the editor. Toggle it with <kbd>Ctrl</kbd>+<kbd>Cmd</kbd>+<kbd>Z</kbd>, or from **View > Enter Zen Mode**.

While it is active:

- The **toolbar** and the utility area's grabber hide, and the title bar goes transparent
- The **tab bar** hides when the editor has a single tab, and stays visible when you have several — hover the top edge to reveal it
- The **navigator** and **inspector** collapse and become edge-hover overlays: move the pointer to the left or right edge to slide one out, move away to dismiss it
- The **utility area** collapses

Exiting restores your exact layout — the same collapsed states, the same panel widths, and a maximized utility area if that is how you left it.

## Inspector

The right sidebar is a quick-glance panel for the current worktree, with one-click shortcuts so you can act without leaving the editor. Toggle it with <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>B</kbd>.

It has four tabs, and it picks the right one for you: **Environment** when no file is focused, **File Inspector** the moment one is.

| Tab | What it's for |
|---|---|
| **Environment** | The worktree at a glance — changes, browser, agents, sources (detailed below) |
| **File Inspector** | The open file: rename it, move it, override its language, and set indentation, tab/indent width, line wrapping, and [Markdown view mode](/docs/features/markdown) for this file alone |
| **Comments** | Every [annotation on the open document](/docs/features/markdown#the-comments-inspector), with its state |
| **History Inspector** | The commit history *of the open file*, newest first — click a commit for its message, author, and date. Merge commits are hidden unless you turn on **Show merge commits in per-file log** in **Settings > Source Control** |

### Environment

| Section | What it shows | Shortcuts |
|---------|---------------|-----------|
| **Environment** | Uncommitted **Changes** (added/removed line counts and changed-file count), the comparison branch, and **View Prompt** for the selected agent terminal | **Create PR** — open a pull request directly or hand it to your PR agent; **Commit** — stage all and commit; **View Prompt** — open the full launch prompt in a tab |
| **Browser** | The page open in the built-in browser | Click to focus the browser |
| **Agents** | The agents running in this worktree, with status and — when enabled — remaining subscription quota | **⟳** — refresh usage for every agent in the card |
| **Sources** | The repository and the worktree's path on disk | — |

### Agent subscription usage

The Agents card can show how much of an agent's subscription remains, right under its name. It is off by default: enable **Show Subscription Usage** on the agent's Configure sheet under [Settings > Agents](/docs/reference/settings#agents) — Agentastic neither shows nor fetches usage for an agent until you do.

- **Claude Code and Codex** are supported to start, each read through the credentials its CLI already stores — no extra sign-in.
- Quota plans show a compact bar with the provider's rate windows, e.g. `58% 5h · 41% wk` for the 5-hour and weekly windows.
- Spend-based accounts show dollar amounts instead: paid overage spend for Claude, credit balances for Codex.
- Usage refreshes itself every few minutes while the card is visible, and the **⟳** in the card header refreshes on demand. Data that couldn't be refreshed is dimmed and marked stale rather than presented as current.

**Create a PR or commit from the Inspector:**

1. Toggle the Inspector with <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>B</kbd>
2. Review the change counts under **Environment**
3. Click **Commit** to stage everything and write a commit message, or **Create PR** to open a pull request. **Source Control > Create a PR (Agent)** hands the job to an agent, which writes the title and body from the diff; **Create a PR (Dialogue)** opens the form so you write them yourself

For the full commit/branch/push workflow, see the **Source Control** section below; to review what changed first, open the [Diff Viewer](/docs/features/diffs).

## Command Palette

Access all commands with <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>.

Type to filter commands, then press Enter to execute. The palette shows keyboard shortcuts for each command.

## Search

### Find in File
- <kbd>Cmd</kbd>+<kbd>F</kbd> - Open find bar
- <kbd>Cmd</kbd>+<kbd>G</kbd> - Find next
- <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> - Find previous

### Find in Project
- <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> - Search across all files
- Configure ignore patterns in Settings

### Replace
- <kbd>Cmd</kbd>+<kbd>Option</kbd>+<kbd>F</kbd> - Find and replace in file

## Language Support

Agentastic supports 100+ programming languages with:

- **Syntax highlighting** via Tree-sitter
- **LSP support** for intelligent features
- **Auto-detection** based on file extension

### Configuring LSP

1. Install a language server (e.g., `typescript-language-server`)
2. Go to **Settings > Languages**
3. Add the server path for your language

When configured, you get:
- Code completion
- Go to definition
- Find references
- Inline errors and warnings

## Source Control

Built-in Git integration:

- **Status view** - See changed files
- **Stage/unstage** - Click the +/- buttons
- **Commit** - Enter message and commit
- **Push/Pull** - Sync with remote
- **Branch switching** - Via dropdown or command palette

## Settings

Access settings with <kbd>Cmd</kbd>+<kbd>,</kbd>.

### Editor Settings
- Font and size
- Tab width
- Word wrap
- Line height

### Terminal Settings
- Backend (Ghostty/SwiftTerm)
- Shell selection
- Font and size
- Cursor style

### Theme
- Editor theme
- Match system dark/light mode

See [Customization](/docs/guides/customization) for detailed configuration options.
