Docs

Quickstart

Zero config required. This is the whole path from install to your first automatic handoff.

1. Run it

kim

On first run, a setup wizard detects which supported tools you have installed and asks which ones you want to use, in what order. That order is your fallback order — the sequence keepitmovin walks through when a tool gets blocked.

2. Work like normal

keepitmovin launches the first tool in a real terminal — it looks and feels exactly like running that tool directly. Your keystrokes go straight through. While you work, keepitmovin keeps a shared handoff file up to date: your goal, what's changed, what's next.

3. Hit a limit — or don't notice you did

When the active tool prints its rate-limit message, keepitmovin recognizes it, checkpoints the handoff file, shows a short "switching tools" note, and launches the next tool in your fallback order with the handoff loaded. The new tool picks up where the last one stopped.

Switch on your own schedule

Press Ctrl+] while a tool runs to hand off to the next tool right now — useful when you want a different tool's take on something, not only when a limit hits.

Where things live

Everything keepitmovin writes stays in your project directory:

.keepitmovin/current/handoff.md   the live handoff file
.keepitmovin/handoffs/            archived handoffs from past sessions
.keepitmovin/sessions/            session summaries

Run kim clear to wipe these anytime. Handoff files can contain task text and terminal output, so keepitmovin writes a .keepitmovin/.gitignore for you and redacts common credential formats before saving — still treat them as sensitive.