IDE
The Agentastic workspace — title bar, multiple repositories, editor, terminal, navigator, utility area, and Zen mode on macOS.
On this page
- Overview
- Title Bar
- Multiple Repositories
- Editor
- Opening Files
- Empty Editor Quick Actions
- Tab Management
- Split Views
- Open in Another App
- Quick Open
- Code Editing
- Terminal
- Ghostty (Recommended)
- WezTerm
- xterm.js
- SwiftTerm
- Terminal Features
- Agent Terminals
- Container Terminals
- Navigator
- Navigator Tabs
- File Operations
- Navigator Position
- Sidebar Style
- Utility Area
- Status Information
- Zen Mode
- Inspector
- Environment
- Agent subscription usage
- Command Palette
- Search
- Find in File
- Find in Project
- Replace
- Language Support
- Configuring LSP
- Source Control
- Settings
- Editor Settings
- Terminal Settings
- Theme
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#
| Action | Shortcut |
|---|---|
| Show Next Tab | Cmd+Shift+] |
| Show Previous Tab | Cmd+Shift+[ |
| Select Next / Previous Tab | Cmd+Option+Right / Left |
| Close Tab | Cmd+W |
| Reopen Closed Tab | Ctrl+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:
| 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 | Cmd+Option+[ |
| Move Line Down | Cmd+Option+] |
| Outdent / Indent Line | Cmd+[ / Cmd+] |
| Toggle Line Comment | Cmd+Option+/ |
| Jump to Definition | Cmd+Ctrl+J |
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+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.
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 | Cmd+Option+J |
| New Terminal Tab | Cmd+T |
| Focus Terminal | Ctrl+` |
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. 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 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.
| 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 for this file alone |
| Comments | Every annotation on the open document, 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 — 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% wkfor 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:
- Toggle the Inspector with Cmd+Option+B
- Review the change counts under Environment
- 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#
- Install a language server (e.g.,
typescript-language-server) - Go to Settings > Languages
- 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.