IDE

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.

Editor

Opening Files

• Click a file in the Navigator to preview it
• Double-click to open in a permanent tab
• Press Cmd+P for Quick Open
• Drag files from Finder into the editor

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 (Cmd+Shift+P) — the cards are just a faster path from a blank pane.

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
• Right-click a tab and select Split Right or Split Down

Quick Open

Press Cmd+P 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	Option+Up
Move Line Down	Option+Down
Duplicate Line	Cmd+D
Delete Line	Cmd+Shift+K
Comment Line	Cmd+/

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

URLs and file paths in any terminal are clickable on a plain click (no Cmd) and can open in a split. See Terminal for the full backend comparison.

Terminal Features

• Multiple tabs - Create tabs with the + button or Cmd+T
• 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	Cmd+1	Project file tree
Search	Cmd+2	Find in project
Source Control	Cmd+3	Git changes
Agents	Cmd+4	Worktree management

File Operations

• New File: Cmd+N
• 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

Utility Area

The bottom panel contains the terminal and other tools.

Action	Shortcut
Toggle Utility Area	Cmd+J
New Terminal Tab	Cmd+T
Focus Terminal	Ctrl+`

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 Cmd+Ctrl+I.

Section	What it shows	Shortcuts
Environment	Uncommitted Changes (added/removed line counts and changed-file count) and the comparison branch	Create PR — open a pull request directly or hand it to your PR agent; Commit — stage all and commit
Browser	The page open in the built-in browser	Click to focus the browser
Agents	Agents configured for this worktree (e.g. the Code Review panel)	—
Sources	The repository and the worktree's path on disk	—

Create a PR or commit from the Inspector:

1. Toggle the Inspector with Cmd+Ctrl+I
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 (Cmd+Shift+P runs your PR agent; Cmd+Ctrl+Shift+P opens the direct form)

For the full commit/branch/push workflow, see the Source Control section below; to review what changed first, open the Diff Viewer.

Command Palette

Access all commands with Cmd+Shift+P.

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

Search

Find in File

• Cmd+F - Open find bar
• Cmd+G - Find next
• Cmd+Shift+G - Find previous

Find in Project

• Cmd+Shift+F - Search across all files
• Configure ignore patterns in Settings

Replace

• Cmd+Option+F - 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 Cmd+,.

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 for detailed configuration options.