Context-aware handoffs for Claude Code. Your AI agent never loses track of what it's building — no matter how many sessions it takes.
Install in 10 seconds ↓When an AI agent's context window fills up, the system compresses earlier messages. Nuanced details vanish. The agent keeps working — but now it's making subtly wrong decisions.
The agent re-asks things it already resolved an hour ago, wasting time and breaking flow.
Implementations silently deviate from decisions made earlier in the session when those decisions get compressed away.
The agent breaks things it just built because it forgot why they were built that way.
Just Keep Swimming makes the agent document everything it knows before context degrades — automatically, with zero ceremony.
Create or import an implementation plan
Work through phases continuously
Capture full context before it fades
Next session picks up seamlessly
The agent monitors its own context health and creates handoff documents automatically when things get heavy. No manual intervention needed.
Each handoff condenses ALL prior sessions' knowledge. The next agent reads one document — not five — and has everything.
Autonomous (just keep swimming) or interactive (pause for review). Switch with a single flag.
Handoffs include exact file paths and line numbers. No vague summaries — the next agent knows exactly where to look.
Blockers are surfaced on resume. Plan amendments capture where reality diverged. Nothing falls through the cracks.
Install with a single command. No state files, no setup wizards. Plans and handoffs are just markdown in your repo.
End-of-day command that reviews commits, code reviews, builds, deploys, writes a summary, and pushes to git. Fully unattended.
Detects your context window size (200k vs 1M) and sets hard phase limits. No "just one more thing" — it hands off before context degrades.
Already discussing architecture? Use --from-context to distill the conversation into a structured plan. Add --now to skip confirmations.
Completed plans stay useful. Bug reports get structured debugging with maintenance logs, not ad-hoc guessing.
Real context preservation, not a vague summary. This is what the next session reads to restore full context.
The agent executes continuously, creating handoffs on its own. Come back to progress or a clean handoff.
/justkeepswimming:go my-feature
Pauses after each phase. Review results, adjust the plan, decide when to continue or hand off.
/justkeepswimming:go my-feature --interactive
| Just Keep Swimming | Heavy workflow systems | |
|---|---|---|
| Installation | 1 plugin command | 30+ files |
| State tracking | Handoff docs only | STATE.md, ROADMAP.md, CONTEXT.md, etc. |
| Concepts to learn | Plan, Execute, Handoff | Projects, Milestones, Phases, Waves, Audits |
| Agent spawning | None | Planners, Executors, Verifiers, Researchers |
| Setup time | 10 seconds | Plugin install + configuration |
| Dependencies | None required | Plugin ecosystem |
| Commands | 2 (plan + night build) | 10+ specialized agents |
Most AI agents fail the same way: they pattern-match to common fixes and try them one by one. Just Keep Swimming ships with six problem-solving principles injected into every session — changing how the agent approaches problems.
Gather facts before forming hypotheses. Every minute understanding the problem saves ten minutes of wrong-direction fixes.
List every condition required for success and verify each one. The broken condition is always the one nobody checks because it's "too basic."
Run diagnostics with an open mind. Read the actual output — don't skim for confirmation of what you already believe.
Systems fail without useful errors all the time. They fall back, return generic messages, or silently skip the broken path. Find the quiet one.
Fix the root cause and only the root cause. The best fix is the smallest change. If you changed more than needed, you didn't understand the problem well enough.
If the user has tried everything, the obvious solutions are exhausted. The answer lives in the layer nobody checked yet. Don't re-run the playbook.
Install as a plugin or copy two files. No dependencies.
/plugin marketplace add cyber-qais/justkeepswimming
/plugin install justkeepswimming
Open any Claude Code session and run:
/justkeepswimming:go my-feature
mkdir -p ~/.claude/commands/justkeepswimming
cp commands/justkeepswimming/*.md ~/.claude/commands/justkeepswimming/
npm install justkeepswimming