IDE

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.

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

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
• Right-click a tab and select Split Right or Split Down

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	Option+Up
Move Line Down	Option+Down
Duplicate Line	Cmd+D
Delete Line	Cmd+Shift+K
Comment Line	Cmd+/

Terminal

Agentastic includes a powerful integrated terminal with two backend options.

Ghostty (Recommended)

GPU-accelerated terminal using Metal for excellent performance:

• Smooth scrolling
• Fast text rendering
• Native macOS feel

SwiftTerm

Pure Swift implementation as a reliable fallback:

• Good compatibility
• Works on all systems

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

File Operations

• New File: Cmd+N
• 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

Utility Area

The bottom panel contains 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

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

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.