Docs

Quickstart

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

1. Run it

kim

On first run, keepitmovin detects which supported tools you have installed and asks one question: which ones do you want to use. It suggests an order and offers to change it. That order is your fallback order— the sequence keepitmovin walks through when a tool gets blocked. Every run after that starts immediately.

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 sharedhandoff 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.