crossmodel.config.example.json

{
  "_comment": "Copy to ~/.claude/crossmodel/crossmodel.config.json to register your own model aliases. IT MUST LIVE IN $HOME: the plugin installs under a versioned path, so a config written into the plugin directory is destroyed by every update and silently reverts you to the built-in aliases. The plugin directory is still searched, as a legacy fallback only. Merged over the built-ins, so reusing a key replaces it. Easiest path: run /crossmodel-setup instead of writing this by hand.",

  "models": {
    "_comment_models": "Aliases are what you type in --model and in routing.json. Keep them short — you will type them constantly.",

    "fast":  { "provider": "codex",  "model": "gpt-5.6-luna" },
    "smart": { "provider": "codex",  "model": "gpt-5.6-sol" },
    "local": { "provider": "ollama", "model": "qwen2.5-coder" },
    "gem":   { "provider": "gemini", "model": "gemini-2.5-pro" }
  },

  "_comment_providers": "Adding a NEW provider needs an args() builder, which JSON cannot express — it belongs in bench/providers.mjs as a pull request. Built in: codex, grok, cursor, opencode, gemini, ollama, claude.",

  "_comment_cursor": "Cursor CLI (bin: agent, needs a Cursor subscription; auth with agent login or CURSOR_API_KEY). VERIFIED with a real run on agent 2026.08.11. One alias ships, cgrok -> cursor-grok-4.6-high; agent --list-models is the authority for the rest, and the same subscription carries GPT-5.6 Sol, Claude Opus 5, Kimi K3 and Composer. Reasoning effort is part of the model id (-low/-medium/-high/-xhigh, optional -fast), not a flag, so crossmodel refuses --effort here instead of dropping it. --network is refused too: Cursor sandbox is only enabled|disabled, with no network knob. It writes freely inside --cwd like every provider here — crossmodel passes --force and Cursor's own default sandbox mode. The single rule anywhere is that git history stays the orchestrator's; see lib/permissions.mjs.",

  "_example_cursor": { "cgrok-x": { "provider": "cursor", "model": "cursor-grok-4.6-xhigh" } },

  "_comment_grok": "xAI Grok Build (bin: grok, needs SuperGrok or X Premium+). Only the 'grok' alias ships; run 'grok models' to see what your subscription offers and add the rest here. A write run uses its 'workspace' profile — edit in --cwd, read anywhere, run the build. Unlike codex it leaves .git/ writable, so the no-commit rule is a contract rather than a lock: review 'git log' as well as the diff. The argument shape is from the published docs, not from a measured run: verify with 'crossmodel --model grok --cwd /tmp/probe \"List the files you can see.\"' before trusting it.",

  "_example_grok": {
    "grok-fast": { "provider": "grok", "model": "grok-build-0.1" }
  },

  "_comment_opencode": "opencode is provider-neutral: it reaches OpenRouter, Ollama, OpenAI, Google and anything OpenAI-compatible through one adapter, so the model string is 'provider/model' as opencode spells it. Run 'opencode models' to see what your install offers. It supports --write under the permission policy in ~/.claude/crossmodel/permissions.json.",

  "_example_opencode": {
    "free":   { "provider": "opencode", "model": "opencode/ling-3.0-flash-fin-free" },
    "router": { "provider": "opencode", "model": "openrouter/deepseek/deepseek-v3" }
  }
}