Settings
The desktop app has two levels of settings: app-level settings that apply globally, and project settings that apply to individual projects.
Open app settings with Cmd+, / Ctrl+, or by clicking Settings in the sidebar.
App Settings
Section titled “App Settings”Choose between Dark, Light, or System (follows OS preference). You can also toggle between dark and light with Cmd+T / Ctrl+T.
Terminal
Section titled “Terminal”Select your preferred terminal application for opening projects:
| Option | Description |
|---|---|
| Terminal | macOS built-in Terminal.app |
| iTerm | iTerm2 (macOS) |
| Warp | Warp terminal |
| WSL | Windows Subsystem for Linux |
View Mode
Section titled “View Mode”Set the default layout for the main dashboard:
| Mode | Description |
|---|---|
| Board | Kanban board with draggable columns and cards |
| Grid | Card grid layout |
| List | Compact table layout |
App Mode
Section titled “App Mode”| Mode | Description |
|---|---|
| Developer | Full feature set with kanban, specs, terminal |
| PM | Simplified view for meetings and project reports |
Health Check Interval
Section titled “Health Check Interval”Set how often the health dashboard runs automated checks (1—168 hours, default: 24).
Auto-Context
Section titled “Auto-Context”When enabled, the app injects project context into Claude Code sessions automatically. This gives AI agents access to your project’s specs, tasks, and issues without manual prompting.
Conversation Archive
Section titled “Conversation Archive”When enabled, completed Claude Code conversations are archived in .mm/conversations/ for future reference.
Auto-Commit
Section titled “Auto-Commit”When enabled, the app automatically creates a git commit when a task is marked complete.
Crash Reporting
Section titled “Crash Reporting”Opt-in local crash reporting. When enabled, unhandled errors are logged locally for debugging. No data is sent externally.
Project Settings
Section titled “Project Settings”Project settings apply to a single project. Open them from the project detail view or the settings gear icon on a project card.
Project Name
Section titled “Project Name”The display name for the project in the dashboard. This is stored in .mm/config.json.
Project Category
Section titled “Project Category”Classify the project as Work or Personal for filtering.
Feature Flags
Section titled “Feature Flags”Toggle individual Monday Morning features per project:
| Feature | Description |
|---|---|
| Project Management | Specs, tasks, issues, and notes tracking |
| Coding Standards | Generate and maintain project coding standards |
| Claude Code Commands | Install slash commands for Claude Code |
| Claude Code Agents | Install agent definitions for Claude Code |
| Tasks as Source of Truth | Use tasks.md as the canonical task tracker |
| Conversation Archive | Archive Claude Code conversations per-project |
Plugin Configuration
Section titled “Plugin Configuration”Each enabled plugin can expose per-project settings. For example, the GitHub plugin shows a repository picker, and the Trello plugin shows board linking options.
Plugin project settings are defined by the plugin’s projectConfig schema. See Settings & Credentials for how plugins declare these fields.
Plugin Settings
Section titled “Plugin Settings”Access plugin settings from the Plugins button in the sidebar. The plugins panel shows:
- All discovered plugins with their name, description, and version
- An enable/disable toggle for each plugin
- Credential fields (API tokens, passwords) for plugins that need authentication
- Global configuration fields defined by each plugin
Plugins are discovered from the MCP server’s plugins/ directory. The desktop app reads the global manifest at ~/.monday-morning/manifest.json to populate this list.
Settings Storage
Section titled “Settings Storage”App settings are persisted to localStorage in the webview. The settingsStore (a Svelte 5 rune-based store) manages all state reactively:
- Theme, sort order, view mode, and layout preferences
- Window dimensions and sidebar collapsed state
- Active task and command tracking
- Plugin enabled/disabled states
- Board column order and card positions
Settings are saved automatically when changed. There is no explicit save button.
Next Steps
Section titled “Next Steps”- Keyboard Shortcuts — Full keyboard shortcut reference.
- Desktop App Overview — UI walkthrough and feature overview.