IDE

The Agentastic workspace — title bar, multiple repositories, editor, terminal, navigator, utility area, and Zen mode on macOS.

View as Markdown

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

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#

ActionShortcut
Show Next TabCmd+Shift+]
Show Previous TabCmd+Shift+[
Select Next / Previous TabCmd+Option+Right / Left
Close TabCmd+W
Reopen Closed TabCtrl+Shift+T

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

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 Cmd+P to open Quick Open with multiple modes:

ModePrefixExample
File Search(none)AppDelegate
Symbol Search@@viewDidLoad
Go to Line::42
File at Linefilename:lineApp.swift:50

Code Editing#

ActionShortcut
Move Line UpCmd+Option+[
Move Line DownCmd+Option+]
Outdent / Indent LineCmd+[ / Cmd+]
Toggle Line CommentCmd+Option+/
Jump to DefinitionCmd+Ctrl+J

Terminal#

Agentastic includes a powerful integrated terminal with four backend options.

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

The left sidebar shows your project structure.

TabShortcutPurpose
FilesCmd+1Project file tree
SearchCmd+2Find in project
Source ControlCmd+3Git changes
AgentsCmd+4Worktree management
Agent ChatCmd+5Run agents as chats

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

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.

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.

ActionShortcut
Toggle Utility AreaCmd+Option+J
New Terminal TabCmd+T
Focus TerminalCtrl+`

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:

ItemWhere it is
Remote hostIn 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. Click the host to reconnect a dropped connection. Absent for local workspaces
Cloud worktreeIn 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 positionAt 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 toggleThe grabber under the editor, the button in the utility area's toolbar, View > Show Utility Area, or Cmd+Option+J

Per-file settings — language, indentation, wrapping, Markdown view mode — live in the File Inspector (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 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 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.

TabWhat it's for
EnvironmentThe worktree at a glance — changes, browser, agents, sources (detailed below)
File InspectorThe open file: rename it, move it, override its language, and set indentation, tab/indent width, line wrapping, and Markdown view mode for this file alone
CommentsEvery annotation on the open document, with its state
History InspectorThe 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#

SectionWhat it showsShortcuts
EnvironmentUncommitted Changes (added/removed line counts and changed-file count), the comparison branch, and View Prompt for the selected agent terminalCreate 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
BrowserThe page open in the built-in browserClick to focus the browser
AgentsThe agents running in this worktree, with status and — when enabled — remaining subscription quota⟳ — refresh usage for every agent in the card
SourcesThe 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+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.

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.