Docs · Guide

Grok App on any model

Grok App (RongleCat/grok-app) is a desktop front end for the grok CLI, which it starts over ACP. Its own model list is Grok Build's official catalog only; a model of your choosing is a provider channel in its settings. magpie adds itself as a custom provider named magpie, so Grok App's model picker offers any model in magpie: DeepSeek, GLM, Kimi, Qwen, Claude or a ChatGPT subscription.

Set up Grok App

  1. Add a provider in magpieAdd an API key on the Providers page, or sign in to a subscription.
  2. Pick a model for Grok App on the Agents pagePick one via magpie, and magpie writes its custom provider.
  3. Press Use in Grok AppPress Use on magpie in Grok App's Settings › Account; that is what moves the App onto magpie.
Terminal
magpie grok-app deepseek/deepseek-v4-pro

magpie's custom provider

magpie writes [model.magpie] in agent-home/config.toml under the App's data folder, the way the App writes a channel itself: the gateway's /v1 as base_url, magpie's own key for Grok App, chat completions. app_models is a JSON list of magpie's models, each with its context window, whether it takes images and its effort levels, so the custom providers in Settings list magpie and the model picker can offer those models and their efforts.

Terminal
# /agent-home/config.toml
[model.magpie]
model = "deepseek/deepseek-v4-pro"
base_url = "http://127.0.0.1:3425/v1"
name = "magpie"
api_key = ""
api_backend = "chat_completions"
app_provider_mode = "generic"
app_models = "[…]"
app_efforts = "[…]"
supports_reasoning_effort = …
context_window = …

The channel's context window, images and efforts follow the model picked. When the picked model is one magpie no longer has, the channel moves to the first in the list.

The route is yours to switch

[models] default is the route the App starts on. magpie doesn't write it: making it magpie takes the App over, and the App then drops its own sign-in and the session no longer runs. So the route stays what the App had, and pressing Use in the App's settings is what switches it, the App's own choice. An older magpie set the route to magpie; this one puts the old route back once, on the next sync or connect, and a Use you press after that stays. A model you pick in the App's picker since is yours too, and stays through a sync.

On magpie, the App starts the CLI with GROK_HOME at agent-home, its independent mode; its default shared mode uses ~/.grok, Grok Build's home.

Models and efforts

Grok Build has no effort none for a channel, so the levels are the model's others. The one the picker starts on is the default you marked for that model on the App's Providers page, while the model still has it, else medium, or the middle level without it.

The data folder

magpie finds Grok App's data folder at $GROK_APP_HOME when it is set, else by system, the first that is there.

Terminal
macOS    ~/Library/Application Support/com.grokapp.grok-app
Windows  %APPDATA%\grokapp\grok-app\data
Linux    $XDG_DATA_HOME/grok-app (~/.local/share/grok-app)
         or ~/.grok-app; $GROK_APP_HOME when set

Disconnecting

Disconnecting takes [model.magpie] out. The route is touched only when it still names magpie, a route that doesn't run: magpie puts back the one it remembered, or clears it. Any other route is the App's and stays. Picking one of the App's own routes in magpie, such as the official Grok, also takes magpie's channel out and makes that the route.

FAQ

Can Grok App run on DeepSeek, GLM or a ChatGPT subscription?

Yes. magpie adds itself as a custom provider in Grok App, so its model picker offers magpie's models; press Use on magpie in its settings to switch.

Why is Grok App not on magpie after connecting?

magpie leaves the App's route alone, as taking it over makes the App drop its own sign-in. Press Use on magpie in Grok App's Settings › Account.

Can I pick an effort in Grok App?

Yes. Each magpie model comes with its own effort levels, starting on the one you marked, else medium.

Does disconnecting put Grok App's old route back?

Yes, when the route still names magpie; any other route is left alone.

More agents on the same models: fx on any model, Aside on any model, Ante on any model and Mister Morph on any model. Something fails? See Fixing common errors, or ask on Discord.