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#

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 Cmd+D to split side by side, or Cmd+Shift+D for top and bottom

Quick Open#

Press Cmd+P to open Quick Open with multiple modes:

Code Editing#

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#

File Operations#

• New File: Cmd+Shift+N
• New File from Clipboard: Cmd+V — 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 same packer is available to agents as dev 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.

Utility Area#

The bottom panel contains the terminal and other tools.

Status Bar#

The thin strip under the editor stays deliberately quiet — four things, all about where you are:

Drag the status bar itself to resize the utility area.

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

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+Option+B.

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

Environment#

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+Option+B
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.

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.