Skip to main content
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

​
Tab management

​
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:

​
Editing shortcuts

​
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

​
File operations

​
Utility area

The bottom panel holds the terminal and other tools.

​
Inspector

The right sidebar shows file information and history.

​
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

​
Find in project

Configure ignore patterns for project search in Settings.

​
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

1

Install a language server

Install the language server for your language. For example:
2

Open Settings > Languages

Use Cmd+, to open Settings, then go to the Languages section.
3

Add the server path

Enter the path to the language server executable for your language.
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 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.