Docs
Configuration
You never need a config file to start — setup writes one for you. Everything below lives in keepitmovin.config.json in your project directory and is optional, so keep your file to just the settings you actually change.
Your tools and fallback order
The config lists your enabled tools and the order keepitmovin falls back through them. Edit both interactively with kim providersrather than by hand.
Usage probes
Keyword detection reacts after a tool prints a limit banner. When a tool records its own remaining usage on disk, keepitmovin can read it and switch before the wall — a usage probe. Today only Codex exposes this; probes are read-only and fail safe. Configure underharness.usageProbe:
| Field | Default | Meaning |
|---|---|---|
enabled | true | Master switch for all usage probes. |
thresholdPercent | 95 | Switch when a tool's highest usage window reaches this percent. |
pollIntervalMs | 30000 | How often to re-check while a tool runs. |
Warning-only watchdog
Loop, abnormal Codex burn, and streaming-stall signals produce local warnings only. They never stop or switch a tool. Configure underharness.watchdog:
| Field | Default | Meaning |
|---|---|---|
enabled | true | Enable conservative loop, burn, and stall warnings. |
A single tool can override the threshold with its ownusageProbe.thresholdPercent. Run kim doctor to see current usage for probed tools.
Handoff refresh
keepitmovin keeps the mechanical sections of thehandoff file fresh on a timer and nudges the active tool if the narrative goes stale. Configure underharness.handoffRefresh:
| Field | Default | Meaning |
|---|---|---|
enabled | true | Master switch for the refresh/nudge system. |
intervalMs | 60000 | How often the mechanical sections are refreshed. |
Task routing
Off by default. Turn it on with "routing": { "enabled": true }. When enabled, keepitmovin classifies your task locally and picks a model and reasoning effort within your fallback order. It never changes your order and makes no network calls for routing.
kim "Investigate the intermittent auth failure"
kim --tier deep "Implement the approved plan"Tiers are light, standard, deep, and max, mapped to appropriate models per tool.--tier is the only routing flag: it overrides the classifier for one run. Automatic routing never selects ultra effort.
Tool updates
Off by default, so starting kim never blocks. Turn it on and keepitmovin asks before running a tool's own verified updater. It never guesses an installer. Configure underupdates:
| Field | Default | Meaning |
|---|---|---|
checkOnStart | false | Check your tools for updates each time keepitmovin starts. Off by default. |
mode | "prompt" | "always" runs updates without asking; "off" skips the check. |
includeDisabledProviders | false | Also check tools outside your fallback order. |