Work with agents
Agents and models
The coding agents Zokie runs, how to connect each one, and how to pick a model, an effort and your loadout.
Zokie doesn't ship its own model. It runs the coding agents you already use, with your own accounts, and shows their work in one chat. Their work counts against your own plans.
The agents
| Agent | You connect it with | Models in the picker | Effort |
|---|---|---|---|
| Claude Code | Your Claude subscription or an API key | Opus 5.5, Fable 5.1, Sonnet 5 | Low to Max |
| Codex | Your Codex sign-in | The models your Codex offers | The levels Codex gives each model |
| Cursor CLI | Your Cursor account | Cursor default, plus the models your account offers | None |
| OpenRouter | Your OpenRouter account | Free models, plus paid models you choose | None |
| Kimi Code, OpenCode, Qwen Code, Goose | Each agent's own sign-in | The agent's own default model | None |
Connect an agent
- Open Settings (⌘,) › Models. Windows uses Ctrl in place of ⌘.
- In the agent's column, click Install or Connect. Kimi Code, OpenCode, Qwen Code and Goose sit under Other models, each on its own card.
- A terminal panel opens and runs the install or sign-in for you. Follow the steps there.
- Close the panel. The agent then lists its models, or its card shows Connected.
If Zokie can't find Claude Code or Codex, set its path in config.json. To change the model an ACP agent (Kimi Code, OpenCode, Qwen Code, Goose) uses, change it in the agent itself.
OpenRouter
OpenRouter needs no program to install.
- In the OpenRouter column, click Get a code. Approve Zokie in your browser and copy the code.
- Paste it into Paste the code from OpenRouter and click Connect. If it's refused, click Get a new code.
- To remove it, click Disconnect OpenRouter.
OpenRouter · free models runs your chat on OpenRouter's free models. OpenRouter limits their daily use, and the chat says when they're busy or used up. On the Free plan you get a set number of OpenRouter tasks; the column shows how many are left.
Paid models come with the paid plans (see Pricing) and bill your own OpenRouter credits. To choose them, click Choose OpenRouter models…, search, tick up to 12 and save. They read Your OpenRouter credits in the picker, and the first time you pick one Zokie asks you to confirm with Use paid models.
Pick a model and effort
Click the model name beside Send to open the picker. It lists only agents that are installed and signed in.
- Auto select sits at the top of code chats while it's on. See Auto mode.
- Loadout lists your chosen models, each with its effort.
- More models opens every connected agent's full list, with its version and account.
- Edit model preferences opens Settings › Models.
Picking a model also picks the agent that runs it. Models with effort levels show an Effort row at the bottom of the picker. Press ⌘⇧/ to step to the next effort level.
You can change the model or effort whenever the agent isn't working; the change applies from your next message. Picking another agent's model moves the chat to that agent, which starts fresh with a summary of the chat so far.
The loadout
The loadout is up to five models you use most. The first is marked Default, and every new chat starts on it, at its effort. Set it in Settings › Models:
- To add a model, drag it from a column onto a slot, or click it.
- To reorder, drag a card to another slot. The first slot is the default.
- To remove one, click the × on its card.
- To change its effort, click the effort on its card.
If you disconnect an agent, its cards stay in the loadout marked Not connected.
What every agent shares
Whichever agent answers, the chat works the same. Its text streams as it types, the commands it runs show in the chat, and its file changes reach the Changes tab. Claude Code can stop to ask you first; Codex, Cursor and the ACP agents don't show permission cards. Your Claude and Codex plan limits show in Your Day.
Guardrails apply to most agents; the chat says when one isn't covered. If your team's guardrails must apply, Zokie runs only agents it can check for the team's tasks.