Agentastic settings reference

Agentastic’s settings are organized into sections that control everything from editor appearance to agent isolation and container configuration. Open Settings with Cmd+, or from the menu bar: Agentastic > Settings.

General

Setting	Description	Default
Show Jump Bar	Display breadcrumb navigation in the editor	On
Focus Dimming	Dim unfocused panes	Off

Text editing

Setting	Description	Default
Font	Editor font face	SF Mono
Font Size	Text size in points	13
Line Height	Line spacing multiplier	1.5
Tab Width	Spaces per tab	4
Insert Spaces	Use spaces instead of tabs	On
Word Wrap	Wrap long lines	On
Markdown View	Render Markdown as plain text, markdown, or split	Markdown

Terminal

Setting	Description	Default
Terminal Emulator	Ghostty or SwiftTerm	Ghostty
Shell	Default shell	System Default
Font	Terminal font face	SF Mono
Font Size	Terminal text size	13
Cursor Style	Block, underline, or bar	Block
Cursor Blink	Animate cursor	On
Option as Meta	Use Option as Meta key	Off

Theme

Setting	Description	Default
Editor Theme	Syntax highlighting theme	Default
Match System	Follow system dark/light mode	On

Search

Setting	Description	Default
Ignore Patterns	Files and folders to exclude from search	`node_modules`, `.git`
Search Limit	Maximum number of results	1000

Keybindings

Customize keyboard shortcuts. Each command can have a custom key combination assigned. Open the Keybindings section to browse all available commands and assign or override shortcuts.

Locations

Setting	Description
Default Save Location	Where new files are saved
Recent Projects	List of recently opened projects

Setting	Description	Default
Show Hidden Files	Display dotfiles in the file tree	Off
Sort Folders First	Show folders before files	On

Source control

Setting	Description	Default
Auto Fetch	Automatically fetch from remote	Off
Fetch Interval	Time between auto fetches	5 min

Agents

View and manage agents (git worktrees) for the current repository.

Feature	Description
Agent List	All agents for the current repo
Create Agent	Add a new agent
Switch Agent	Change the active agent
Remove Agent	Delete an agent

Worktree settings

Setting	Description	Default
Worktree Location	Where new worktrees are stored	Adjacent
Worktree Setup Script	Path to the setup script run when a new worktree is created	`.agentastic/setup.sh`

Container settings

Setting	Description	Default
Container Images	Docker images available for container mode	See defaults
Setup Script Path	Custom container setup script location	`~/.config/agentastic/container-setup.sh`
Mount Git Config	Share `~/.gitconfig` with containers	On
Mount SSH Keys	Share `~/.ssh/` with containers	Off
Copy Shell Config	Copy shell configuration files to the container home	On
Network Mode	Container network access: Bridge, Restricted, or None	Bridge

For detailed documentation on container configuration, see Agents.

Accounts

Manage connected accounts for integrations. Use this section to add or remove authentication for services your agents and workflows depend on.

Code review

Setting	Description	Default
Default Agent	Preferred review agent	Claude
Custom Command	Command for a custom review agent	—
Auto Review	Automatically review on save	Off

Developer

Advanced settings for troubleshooting Agentastic itself.

Setting	Description
Debug Mode	Enable verbose debug logging in the console

Enabling debug mode may affect performance and produce verbose output. Use it only when troubleshooting.

Get Started

Features

Guides

Reference

Help

Agentastic settings reference

General

Text editing

Terminal

Theme

Search

Keybindings

Locations

Navigation

Source control

Agents

Worktree settings

Container settings

Accounts

Code review

Developer

​General

​Text editing

​Terminal

​Theme

​Search

​Keybindings

​Locations

​Navigation

​Source control

​Agents

​Worktree settings

​Container settings

​Accounts

​Code review

​Developer

General

Text editing

Terminal

Theme

Search

Keybindings

Locations

Navigation

Source control

Agents

Worktree settings

Container settings

Accounts

Code review

Developer