Files
Maestro/docs/configuration.md
Pedram Amini 2a195dba80 ## CHANGES
- Added context window warnings with one-click “Compact & Continue” compression 🚦
- Introduced per-tab input toggles for History, Read-only, and Thinking modes 🎛️
- Enabled configurable default toggle states for new AI tabs in Settings 🧩
- Added flexible send-key configuration for AI and terminal modes ⌨️
- Shipped Image Carousel for managing multi-image attachments fast 🖼️
- Expanded Git docs with built-in log viewer and commit navigation 🌿
- Documented syntax-highlighted diff viewer with side-by-side comparisons 🔍
- Upgraded worktree workflows: manage, watch changes, PRs, safe removal 🧰
- Added comprehensive AI tab shortcut table for all toggle actions 🗂️
- Documented shortcut remapping flow, conflict behavior, and restoration tips 🧠
2025-12-27 11:59:12 -06:00

1.7 KiB

title, description, icon
title description icon
Configuration Storage locations, cross-device sync, and Maestro configuration options. settings

Settings are stored in:

  • macOS: ~/Library/Application Support/maestro/
  • Windows: %APPDATA%/maestro/
  • Linux: ~/.config/maestro/

Cross-Device Sync (Beta)

Maestro can sync settings, sessions, and groups across multiple devices by storing them in a cloud-synced folder like iCloud Drive, Dropbox, or OneDrive.

Setup:

  1. Open Settings (Cmd+, / Ctrl+,) → General tab
  2. Scroll to Storage Location
  3. Click Choose Folder... and select a synced folder:
    • iCloud Drive: ~/Library/Mobile Documents/com~apple~CloudDocs/Maestro
    • Dropbox: ~/Dropbox/Maestro
    • OneDrive: ~/OneDrive/Maestro
  4. Maestro will migrate your existing settings to the new location
  5. Restart Maestro for changes to take effect
  6. Repeat on your other devices, selecting the same synced folder

What syncs:

  • Settings and preferences
  • Session configurations
  • Groups and organization
  • Agent configurations
  • Session origins and metadata

What stays local:

  • Window size and position (device-specific)
  • The bootstrap file that points to your sync location

Important limitations:

  • Single-device usage: Only run Maestro on one device at a time. Running simultaneously on multiple devices can cause sync conflicts where the last write wins.
  • No conflict resolution: If settings are modified on two devices before syncing completes, one set of changes will be lost.
  • Restart required: Changes to storage location require an app restart to take effect.

To reset to the default location, click Use Default in the Storage Location settings.