Settings and Storage
Fletch keeps configuration light — preferences, per-agent providers, and the libraries your custom agents draw on — and stores everything you create on your own machine.
Settings
Section titled “Settings”Open the quick settings popover with ⌘, (appearance, panel and composer toggles, and provider switches), or go to All settings for the full screen. The full settings screen has these sections:
- Account — your name and email, the GitHub connection (connect/disconnect), and a Developer-tools readiness check for
git. - General — Theme (Dark/Light) and Accent (Copper, Rust, Olive, Sage, Ocean, Plum); toggles for the Git, Code, Run, and Terminal side panels; composer toggles for Thinking budget, Auto-edit, and Token usage; Notifications — a completion Sound and Native notifications for when an agent finishes or needs input while you’re looking elsewhere; Sandbox — the engine choice (Seatbelt or Docker) and, for Docker, Claude auth for containers; and Diagnostics — the Usage analytics toggle and Reveal logs.
- Providers — enable or disable each agent, see its detected binary path and version, set a binary path override, and Re-scan system.
- Custom agents — save presets with a name, color, description, base agent, model, reasoning budget, standing instructions, and attached Skills and Tools.
- Workflows — build, import, and export workflow definitions.
- Skills — the library of instruction documents agents load on demand — see Skills and Tools.
- Tools — your MCP servers (stdio or HTTP) — same page.
- Experimental — the Native terminal view toggle, plus advanced Docker knobs: container image, memory limit (default 4g), and CPU limit (default 2).
Run configuration, shared environment variables, the project’s display name and location, and project deletion are set per project (the gear on a project in the sidebar) — see Run Configuration; everything above applies app-wide.
Where your data lives
Section titled “Where your data lives”Everything Fletch creates stays on your Mac. Your projects, sessions, transcripts, settings, custom agents, skills, tool servers, and workflow definitions are kept in a local database; each agent’s workspace lives in its own folder on disk; and logs are kept locally — open them with Reveal logs in General. Nothing is stored on a remote server.