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.

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

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

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
Agent Chat	Cmd+5	Run agents as chats

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

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.

Utility Area#

The bottom panel contains the terminal and other tools.

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

Zen Mode#

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

While it is active:

• The toolbar and status bar 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 Cmd+Ctrl+I.

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