Skip to main content

​
~/.magnitude/

Magnitude creates ~/.magnitude/ automatically to store your local settings, credentials, and runtime data.
PathPurpose
config.jsonPreferences and global settings
auth.jsonStored provider credentials
sessions/Session history
logs/CLI and event logs
skills/Global Magnitude skills
model-catalog/Model catalog cache
traces/Debug trace data

​
config.json

~/.magnitude/config.json stores your global Magnitude preferences. You can edit these toggles directly:
  • "memory": false — disables learned preferences
  • "telemetry": false — opts out of anonymous telemetry (also controllable via MAGNITUDE_TELEMETRY)
It also stores model selections, provider options, machineId, and setupComplete (typically managed through /settings). 
{
  "roles": {
    "lead": { "model": { "providerId": "anthropic", "modelId": "claude-opus-4-6" } },
    "explorer": { "model": { "providerId": "anthropic", "modelId": "claude-sonnet-4-6" } },
    "planner": { "model": { "providerId": "anthropic", "modelId": "claude-sonnet-4-6" } },
    "builder": { "model": { "providerId": "anthropic", "modelId": "claude-sonnet-4-6" } },
    "reviewer": { "model": { "providerId": "anthropic", "modelId": "claude-sonnet-4-6" } },
    "debugger": { "model": { "providerId": "anthropic", "modelId": "claude-sonnet-4-6" } },
    "browser": { "model": { "providerId": "anthropic", "modelId": "claude-haiku-4-5" } }
  },
  "providers": {
    "local": { "baseUrl": "http://localhost:1234/v1", "modelId": "qwen2.5-coder" }
  },
  "setupComplete": true,
  "machineId": "your-machine-id",
  "memory": true,
  "telemetry": true
}
Use /settings for normal configuration changes. Edit config.json manually only when you need direct control.

​
auth.json

~/.magnitude/auth.json stores provider API keys and OAuth tokens used by Magnitude.
  • File permissions are restricted (600)
  • Delete this file to clear saved credentials and re-authenticate providers

​
AGENTS.md

Run /init to generate an AGENTS.md file that gives Magnitude context about your project.

​
sessions/

~/.magnitude/sessions/ stores your conversation history and artifacts. See Sessions for details.

​
logs/

~/.magnitude/logs/ stores CLI and event logs. You can inspect them with bun logs.

​
traces/

~/.magnitude/traces/ stores debug trace output when tracing is enabled.