Settings & Preferences

Fresh

Open Settings with Ctrl+, (Windows/Linux) or Cmd+, (macOS).

Settings Tabs Overview

Tab	What It Controls
General	Conductor profile, shell config, defaults, WakaTime, updates, privacy
Display	Fonts, terminal width, log level, context warnings
Shortcuts	All keyboard shortcuts (customizable)
Themes	17 built-in + custom theme builder
Notifications	OS alerts, custom commands, toast duration
AI Commands	Slash commands, Spec-Kit, OpenSpec prompts
SSH Hosts	Remote host configurations
Encore Features	Opt-in power features (Director's Notes)

General Tab

Conductor Profile (About Me)

A short description injected into every agent's system prompt. Helps agents understand your background and preferences.

Security researcher. macOS desktop. TypeScript and Python for tools.
Direct communication, no fluff. Action over process.
Generate markdown for Obsidian. CST timezone.

Shell Configuration

• Global Environment Variables: KEY=VALUE format, one per line
• Applies to all new sessions immediately
• Precedence: Session overrides > Global > Agent-specific > System

Defaults

• Input Send Behavior: Enter or Cmd+Enter
• Save to History: On/off by default
• Show Thinking: On/off by default
• Automatic Tab Naming: Let AI name tabs based on conversation

Power Management

Sleep prevention activates automatically when sessions are busy, Auto Run is active, or Group Chat is in progress. Works on macOS, Windows, and GNOME/KDE/XFCE on Linux.

WakaTime Integration

Tracks time as:

• building — Interactive sessions
• ai coding — Auto Run sessions

Optional detailed file tracking sends per-file write heartbeats for Claude Code (Write, Edit, NotebookEdit), Codex (write_to_file, str_replace_based_edit_tool), and OpenCode (write, patch).

Updates

• Auto-check on startup (configurable)
• Manual: Ctrl+K → "Check for Updates"
• Pre-release opt-in: alpha, beta, rc, dev, canary suffixes

Display Tab

• Font family and size for both UI and terminal
• Terminal width (character count)
• Log level and buffer size
• Max output lines per response
• Context window warnings: Yellow at 60% (default), Red at 80% (default) — both configurable

Notifications Tab

• OS notifications: Alert on task complete, long command finish, agent attention needed
• Custom notification command: Execute any command accepting stdin (e.g., say on macOS, espeak on Linux)
• Toast duration: Off, 5s, 10s, 20s, 30s, or Never

Storage Locations

Platform	Path
macOS	~/Library/Application Support/maestro/
Windows	%APPDATA%/maestro/
Linux	~/.config/maestro/

Cross-Device Sync (Beta)

Point storage to a cloud-synced folder (iCloud Drive, Dropbox, OneDrive). Settings, sessions, groups, and agent configs sync. Window size/position stays local.

WARNING

Only run Maestro on one device at a time — no conflict resolution.

Stripped Environment Variables

These are automatically removed to prevent Electron context leaking to agents: ELECTRON_RUN_AS_NODE, ELECTRON_NO_ASAR, CLAUDECODE, CLAUDE_CODE_ENTRYPOINT, NODE_ENV

See Also

• Themes & Customization — Full theme reference
• Keyboard Shortcuts — All shortcuts
• Slash Commands — AI Commands configuration