Documentation Index
Fetch the complete documentation index at: https://docs.agentastic.dev/llms.txt
Use this file to discover all available pages before exploring further.
Agentastic is a complete development environment, not just an AI launcher. It includes a native macOS code editor with syntax highlighting and LSP support, a GPU-accelerated terminal with multiple backends, built-in Git integration, and a project Navigator — all designed to work seamlessly with AI agent workflows.
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
Press Cmd+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 or Cmd+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
Press Cmd+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
Install a language server
Install the language server for your language. For example:npm install -g typescript-language-server
Open Settings > Languages
Use Cmd+, to open Settings, then go to the Languages section.
Add the server path
Enter the path to the language server executable for your language.
- 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 with Cmd+,.
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
For detailed configuration options, see Customization.