🔀 Session Memory Persistence

Your agent remembers
everything.

Never lose session context again. agent-handoff persists decisions, technical details, open questions, and next steps across agent resets, compactions, and new sessions.

View on GitHub Quick Install →
/handoff save "finished auth module"
$ /handoff save "finished auth module, starting on payment"
Saving handoff checkpoint
decisions 14 items saved
files src/auth/*, tests/auth/*
open 3 open questions preserved
next payment integration with Stripe
Done handoff saved.
$ /handoff load auth-2025-06-02
Context restored. Ready to continue.
Features

Seamless memory across agent resets

agent-handoff creates structured memory files your agent loads at the start of each new session.

💾

Checkpoint Saves

Save full session context as a structured Markdown + JSON file in one command. File list, decisions, next steps, open questions all captured.

📖

Context Restore

Load any prior checkpoint at session start. The agent reads the structured file and is immediately oriented without any re-explaining.

🔍

Cross-Session Search

Search all prior handoffs for a file path, decision, or keyword. Never wonder "did I implement that already?" in seconds.

🔗

Agent Chaining

Hand off between different AI agents: from Copilot to Cursor, or from a subagent back to the main agent with full fidelity.

📊

Timeline View

List all handoffs in chronological order with one-line summaries. Understand the arc of a long project at a glance.

🔒

Local Only

All handoff files stay on your machine. No cloud sync, no telemetry. The format is plain Markdown, readable without any tooling.

Install agent-handoff

Python 3.8+. Zero runtime dependencies.

$ git clone https://github.com/codes1gn/agent-handoff
$ cd agent-handoff && pip install -e .
# In your AI chat: /handoff save "description of current state"
View on GitHub Skill Docs