
Set the fork secondary model in Grok Build
Set the fork secondary model in Grok Build
fork_secondary_model under [ui] picks which model the secondary agent uses when you fork. When unset, it follows the main session default. Official: Settings reference, Sessions.
Config
User config (~/.grok/config.toml or $GROK_HOME/config.toml):
[ui]
fork_secondary_model = "grok-build"
Replace the string with any model id available in your catalog (same space as /model and grok models).
How it fits with /fork
/forkbranches the current session into a peer — Fork a Grok Build session.- The secondary peer uses
fork_secondary_modelwhen set; otherwise the same default as new sessions ([models] default/GROK_DEFAULT_MODEL). - Worktree forks (
--worktree/-w) still isolate the checkout; this key only routes the model for that secondary agent.
Related model picks
List ids: List available models with grok models. Switch the active session model: Switch active model in Grok Build.
Pitfalls
- Putting
[ui]in project.grok/config.toml— user config only. - Setting an id that is
hiddenordisabledin[models]— hidden ids may still work via-m; disabled ids are removed from the catalog.