Settings
Midcore is configured through project files, environment variables, and (where applicable) IDE or desktop app settings. Project-level config overrides user-level where both exist.
Config locations
| Location | Scope | Typical use |
|---|---|---|
| .maestro/intent.yaml | Project | Intent and delivery tier |
| .maestro/gates.yaml | Project | Gate definitions and order |
| .maestro/hooks.json | Project | Lifecycle hooks |
| .midcore/rules/*.mdc | Project | Rules and conventions |
| AGENTS.md | Project | Persistent instructions |
| Environment variables | User / system | API URL, auth, feature flags |
| IDE / Desktop settings | User | Theme, keybindings, default mode |
Project settings
Project settings live under .maestro/ and .midcore/. They are versioned with the repo so the whole team gets the same behavior. See intent.yaml, Gates reference, and Extend Midcore for details.
User and environment
API base URL, authentication, and feature flags are usually set via environment variables so you don't commit secrets. IDE and Desktop apps may expose a settings UI that writes to a user config file; see the app's help for the exact path.
Related documentation
Environment variables · CLI reference · Troubleshooting · Glossary · API overview