oh-my-cursor/config.default.jsonc at cursor-dev · andrescera/oh-my-cursor · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
{
  "$schema": "./dist/oh-my-cursor.schema.json",
  // oh-my-cursor configuration
  // Location: ~/.config/oh-my-cursor/config.jsonc
  // Project override: .cursor/oh-my-cursor.jsonc (takes precedence)

  // Orchestration mode:
  //   "native"   — Root thread adopts personas (Plan mode = Prometheus, Agent mode = Atlas).
  //                Commands like /plan use SwitchMode. Full conversation context is preserved.
  //   "subagent" — Classic behavior. /plan dispatches Task(prometheus), /start-work dispatches Task(atlas).
  //                Better for very large plans (50+ tasks) where context window may fill up.
  "orchestration": {
    "mode": "native"
  },

  // Subagent dispatch limits per user turn
  "subagent_limits": {
    "explore": 6,
    "worker": 8
  },

  // Hook daemon ports
  "daemon": {
    "port": 27847,
    "mcp_port": 27848
  },

  // Context collector settings
  "context_collector": {
    "enabled": true,
    "max_context_chars": 50000
  },

  // Compaction settings
  "compaction": {
    "prompt_enabled": true
  },

  // State persistence (session state across restarts)
  "state_persistence": {
    "enabled": true,
    "path": "/tmp/oh-my-cursor-state.json"
  },

  // Notifications
  "notifications": {
    "enabled": true,
    "sound": false
  },

  // Disable specific hooks by name (e.g. ["context-injector", "mdc-writer"])
  "disabled_hooks": [],

  // Disable specific agents (e.g. ["ralph", "boulder"])
  "disabled_agents": [],

  // MCP server allowlist ("*" = all)
  "mcp_allowlist": ["*"],

  // Experimental features
  "experimental": {
    "cloud_agents": false,
    "webhooks": false,
    "automations": false
  },

  // [DEPRECATED] Model defaults per subagent type.
  // Still parsed for backward compatibility, but entries here are automatically
  // migrated into "agent_overrides" at load time (with a one-time deprecation
  // warning). Prefer "agent_overrides" below for new configs.
  // Values: "composer-2-fast" (same capability as composer-2, higher priority)
  // or "inherit" (uses parent model).
  "model_routing": {
    "defaults": {
      "explore": "composer-2-fast",
      "librarian": "composer-2-fast"
    },
    // enforce_allowlist: false,  // When true, out-of-allowlist models for curated agents are remapped to the agent's default (never denied). Default: false.
  },

  // Per-agent model overrides (preferred over the deprecated model_routing).
  // Keyed by subagent_type name (e.g. "explore", "sisyphus"). Each entry supports:
  //   "model"           — Cursor model slug to use (e.g. "composer-2-fast")
  //   "fallback_models" — ordered slugs to try if "model" is unavailable
  //   "disable"         — true to disable dispatching this agent entirely
  //
  // Validation: "model" and each entry in "fallback_models" are checked against a
  // per-subagent_type curated allowlist (hooks/lib/agent-model-allowlist.ts).
  //   - "inherit" is always allowed and skips all allowlist checks.
  //   - An unrecognised slug logs a warning at write-time and an advisory at dispatch-time.
  //   - The dashboard shows a banner for any active invalid override with a one-click reset.
  //   - Invalid overrides NEVER block dispatch; the slug is passed through as-is.
  // "agent_overrides": {
  //   "explore": {
  //     "model": "composer-2-fast",
  //     "fallback_models": ["composer-2.5", "inherit"],
  //     "disable": false
  //   }
  // },

  // Category-level overrides. Same fields as agent_overrides plus "description".
  // Use to group agents/tasks under a shared routing policy.
  // Category model values are subject to the same per-subagent_type allowlist validation
  // and advisory/banner behaviour described above.
  // "categories": {
  //   "quick": {
  //     "model": "composer-2-fast",
  //     "fallback_models": ["composer-2.5"],
  //     "disable": false,
  //     "description": "Fast, cheap tasks"
  //   }
  // },

  // Max characters of piggybacked context appended to a dispatched task.
  "max_piggyback_chars": 8000,

  // Model introspection (scans available Cursor models for advisory validation).
  //   "enabled"           — turn the scan on/off
  //   "scan_timeout_ms"   — upper bound on the async scan
  //   "extra_bundle_paths"— additional model bundle paths to scan
  "introspection": {
    "enabled": true,
    "scan_timeout_ms": 2000,
    "extra_bundle_paths": []
  }
}