Reference
config.json
The settings you can change by hand in Zokie's config.json, and what each one does.
Most settings live in Settings. A few extra ones live in ~/.zokie/config.json, a small file you can edit by hand.
Keys you can edit
| Key | Default | What it does |
|---|---|---|
branchPrefix | Your user name | The first part of every branch Zokie makes. |
claudePath | "" | Full path to the claude command, if Zokie can't find it. |
codexPath | "" | Full path to the codex command, if Zokie can't find it. |
idleExitMinutes | 10 | Minutes an idle agent stays running after its last reply, from 1 to 240. The chat picks up where it left off when you write again. |
permissionMode | "auto" | The permission mode new chats start in: auto, manual, acceptEdits, plan, dontAsk or bypassPermissions. See Safety. |
disableAnalytics | false | true stops anonymous product events. |
disableChatCards | false | true stops new chats answering with cards. |
agentAccess | "" | handsfree lets an agent also keep its task's card up to date. Empty means the essentials: the terminal, subtasks, the plan and showing a pane. See MCP. |
The cards and agent access switches in Settings set disableChatCards and agentAccess for you.
Applying changes
After you edit the file by hand, quit and reopen Zokie. Changes made in Settings need no restart.
If the file isn't valid JSON, Zokie starts with its defaults and shows a banner: config.json is not valid JSON, using defaults. Fix the file and reopen Zokie.