Editor
Opening files
| Method | Action |
|---|---|
| Single-click in Navigator | Preview the file (closes when you open another) |
| Double-click in Navigator | Open in a permanent tab |
Cmd+P | Quick Open — search by name, symbol, or line |
| Drag from Finder | Drop a file into the editor area |
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 of the editor to create a split.
- Right-click any tab and select Split Right or Split Down.
Quick Open
PressCmd+P to open Quick Open. It supports several modes depending on what you type:
| Mode | Prefix | Example |
|---|---|---|
| File search | (none) | AppDelegate |
| Symbol search | @ | @viewDidLoad |
| Go to line | : | :42 |
| File at specific line | filename:line | App.swift:50 |
Editing shortcuts
| Action | Shortcut |
|---|---|
| Move line up | Option+Up |
| Move line down | Option+Down |
| Duplicate line | Cmd+D |
| Delete line | Cmd+Shift+K |
| Comment / uncomment line | Cmd+/ |
Terminal
Agentastic includes an integrated terminal with two backend options. Switch between them in Settings > Terminal.Ghostty (recommended)
A GPU-accelerated terminal renderer using Metal. Ghostty delivers:- Smooth scrolling and fast text rendering
- Native macOS look and feel
- Excellent performance for output-heavy agent sessions
SwiftTerm
A pure Swift terminal implementation used as a reliable fallback:- Good compatibility across all systems
- Solid alternative when Ghostty is unavailable
Terminal features
- Multiple tabs — add tabs with the
+button orCmd+T. - Shell integration — tab titles update to show the current directory.
- Option as Meta — use the Option key as Meta in Vim and Emacs.
- Theme integration — terminal colors follow your editor theme.
Agent terminals
Each agent (worktree) has its own set of terminal tabs:- Switching to a different worktree switches its terminal tabs into view.
- Terminal state (history, running processes) persists per agent.
- New terminal tabs open in the agent’s working directory automatically.
Container terminals
For agents running in Docker containers, terminal commands execute inside the container:- Working directory is
/workspace(where your worktree is mounted). - Your shell configuration is available inside the container.
Navigator
The left sidebar gives you access to your project’s files and tools.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
| Action | How |
|---|---|
| New file | Cmd+N |
| New folder | Right-click > New Folder |
| Rename | Select file, press Enter |
| Delete | Press Delete, or right-click > Delete |
| Reveal in Finder | Right-click > Show in Finder |
Utility area
The bottom panel holds the terminal and other tools.| Action | Shortcut |
|---|---|
| Toggle utility area | Cmd+J |
| New terminal tab | Cmd+T |
| Focus terminal | `Ctrl+“ |
Inspector
The right sidebar shows file information and history.| Action | Shortcut |
|---|---|
| Toggle Inspector | Cmd+Ctrl+I |
Command Palette
PressCmd+Shift+P to open the Command Palette. Type to filter the available commands, then press Enter to execute. Keyboard shortcuts for each command are shown inline.
Search
Find in file
| Action | Shortcut |
|---|---|
| Open find bar | Cmd+F |
| Find next | Cmd+G |
| Find previous | Cmd+Shift+G |
| Find and replace | Cmd+Option+F |
Find in project
| Action | Shortcut |
|---|---|
| Search across all files | Cmd+Shift+F |
Language support
Agentastic supports 100+ programming languages with:- Syntax highlighting — powered by Tree-sitter for accurate, fast highlighting.
- LSP support — connect language servers for intelligent editing features.
- Auto-detection — language mode is set automatically based on file extension.
Configuring LSP
Once configured, you get:
- Code completion
- Go to definition
- Find all references
- Inline errors and warnings
Source control
Agentastic has built-in Git integration accessible from the Source Control Navigator (Cmd+3):
- Status view — see all modified, added, and deleted files.
- Stage / unstage — click the
+or-buttons next to each file. - Commit — enter a commit message and commit directly from the panel.
- Push / Pull — sync your branch with the remote.
- Branch switching — use the branch dropdown or the Command Palette.
Settings
Open Settings withCmd+,.
Editor settings
- Font family and size
- Tab width
- Word wrap
- Line height
Terminal settings
- Backend (Ghostty or SwiftTerm)
- Shell selection
- Font and size
- Cursor style
Theme
- Editor color theme
- Option to match the system dark/light mode automatically