FAQ

Frequently asked questions about Agentastic

General

What is Agentastic?

Agentastic is a native macOS terminal / code editor designed for AI agentic coding workflows. It supports built-in git workflows for running ai agents in parallel. It's built with Ghostty, Swift, and SwiftUI, providing a lightweight yet powerful terminal and coding experience.

What makes Agentastic different from other editors?

  • Native macOS - Built specifically for macOS with Swift/SwiftUI
  • Ghostty Terminal - with GPU rendering, for fast and smooth agent experience
  • Agent PanelG - Seamless multi-branch workflows via git worktrees to run agents in parallel without collsions
  • TUI agent support - virtually supporting every agent on the market, Anthropic Claude Code, OpenAI Codex, Factory Droid, Amp, OpenCode, even Cursor-Agent.
  • AI Agent Code Review Integration - First-class support for Code review agents, Claude, Codex, CodeRabbit and Cursor (You can add more)
  • Git integration - built-in diff viewer and git manager
  • Dual Terminal Backend - Choose between Ghostty (GPU-accelerated) or SwiftTerm
  • Lightweight - Fast startup and low resource usage
  • Code Editor - Lightweight xcode-like experience with LSP support for code editing

Is Agentastic free?

Agentastic Dev is free for use.

Do you train on my code?

No, Agentastic Dev does not collect any data for training or otherwise.

What macOS versions are supported?

Agentastic requires macOS 14.0 (Sonoma) or later. Both Apple Silicon and Intel Macs are supported.

Features

Does Agentastic support extensions?

Extension support is available. Check Settings > Extensions for available extensions.

Can I use Agentastic with my existing Git setup?

Yes. Agentastic uses your system Git installation and respects your global Git configuration.

Does Agentastic support multiple windows?

Yes. Open multiple workspaces in separate windows via File > New Window or by opening projects while holding Option.

Can I customize the editor theme?

Yes. Go to Settings > Theme to choose from available themes. Custom theme creation support is planned.

Terminal

What's the difference between Ghostty and SwiftTerm?

  • Ghostty uses GPU-accelerated rendering via Metal for smooth performance
  • SwiftTerm is a pure Swift implementation that works as a reliable fallback

Both provide full terminal functionality; Ghostty offers better performance on supported systems.

Can I use my custom shell?

Yes. In Settings > Terminal, select Custom and enter the path to your shell (e.g., /opt/homebrew/bin/fish).

How do I get Powerline/Nerd Font glyphs to work?

Install a Nerd Font (like FiraCode Nerd Font) and select it in Settings > Terminal > Font.

Code Review

Which AI agents are supported?

  • Claude Code (Anthropic)
  • Codex (OpenAI)
  • CodeRabbit
  • Custom agents via command configuration

Do I need API keys for AI features?

Some agents require API access or subscription. Configure credentials in the agent settings. Refer to the Agent's developer (Anthropic, OpenAI, etc) for their subscription plans or API keys.

Is my code sent to external servers?

Agentastic Dev does not collect your data. When using AI code review, selected code is sent to the configured agent's API. Review each agent's privacy policy for details.

Git & Source Control

Why can't I see my Git history?

Ensure the project root contains a .git directory. Git features require a valid Git repository.

How does the agents panel work?

The agents panel uses git worktrees to let you check out multiple branches simultaneously in different directories. Each agent works in its own isolated worktree. See Git Worktrees for details.

Can I use Git LFS?

Yes, if Git LFS is installed on your system, Agentastic will use it automatically.

Performance

How can I improve performance with large projects?

  1. Close unused tabs
  2. Add large directories to search ignore patterns
  3. Disable unused language servers
  4. Give LSP servers time to complete initial indexing

Why is my CPU usage high?

This is usually caused by language servers indexing. Wait for initial indexing to complete. If the issue persists, try disabling LSP temporarily.

Troubleshooting

Where are settings stored?

Settings are stored in ~/Library/Application Support/Agentastic/.

How do I reset to defaults?

  1. Quit Agentastic
  2. Remove the settings folder: 
    rm -rf ~/Library/Application\ Support/Agentastic
  3. Relaunch Agentastic

How do I report a bug?

Report bugs on GitHub Issues with:

  • macOS version
  • Agentastic version
  • Steps to reproduce
  • Expected vs actual behavior

Getting Help

Where can I get support?