
Restore Context
- 1 installs
- Updated February 19, 2026
- aesirsystems/claude-breadcrumbs
restore-context is a Claude Code skill that restores an agent's full working context after a compaction by reading recovery files, syncing beads state, and verifying git.
About
restore-context is a Claude Code skill that rebuilds an agent's working context after a session compaction or a new session start. It reads .beads recovery files, syncs beads task state, checks git status, and prints a structured summary of the current epic and available work. A developer runs it at the top of a resumed session so the agent knows what it was doing before continuing.
- Restores full working context after a compaction or a fresh session
- Reads .beads recovery files, syncs beads state, and verifies git status
- Presents a structured summary then waits for the user to pick a task
Restore Context by the numbers
- 1 all-time installs (skills.sh)
- Ranked #14,102 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Jul 7, 2026 (Skillselion catalog sync)
restore-context capabilities & compatibility
- Capabilities
- context restoration · session recovery · task tracking
- Works with
- github
- Use cases
- memory · planning
What restore-context says it does
Restore full context after compaction or starting a new session. Reads recovery files, syncs beads state, verifies git state, and presents summary with available work.
You are returning after compaction or time away. Follow this process to restore COMPLETE context.
npx skills add https://github.com/aesirsystems/claude-breadcrumbs --skill restore-contextAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| Last updated | February 19, 2026 |
| Repository | aesirsystems/claude-breadcrumbs ↗ |
What it does
Restore an agent's full project context after compaction so work can resume without re-explaining state.
When should I use this skill?
You are returning to a project after a compaction or time away and need to rebuild full context before continuing.
What you get
A structured context summary showing the current epic, last session's work, available tasks, and git state.
- Structured context-restored summary with epic, available work, and git state
By the numbers
- 4-step restore process (recovery prompt, recovery file, beads sync, git verify)
- 5-item fallback process when no recovery file exists
Files
Restore Context
You are returning after compaction or time away. Follow this process to restore COMPLETE context.
---
Step 0: Read Recovery Prompt (Quick Start)
if [ -f .beads/recovery-prompt.md ]; then
cat .beads/recovery-prompt.md
echo ""
echo "--- Recovery prompt found. Reading full context next... ---"
else
echo "No recovery prompt found. Will read recovery context directly."
fi---
Step 1: Read Recovery File
cat .beads/recovery-context.md 2>/dev/null || cat recovery-context.md 2>/dev/null || echo "No recovery file found"Absorb:
- Current epic and success criteria
- Scope guard rails
- Key decisions and why
- Current challenges
- Exact state of in-progress work
---
Step 2: Sync and Review Beads
bd sync --from-main 2>/dev/null || true
bd ready
bd list --status openIf beads is not available, skip this step.
---
Step 3: Verify Git State
git status
git log --oneline -5
git branch --show-currentIf not in a git repo, skip this step.
---
Step 4: Present Summary and Get Direction
Show the user:
## Context Restored
### Current Epic
**[Epic name]**
- Goal: [brief description]
- Success: [1-2 key criteria]
### Last Session Completed
- [Major accomplishment 1]
- [Major accomplishment 2]
### Available Work (bd ready)
1. **[task-id]** - [Title] (P[priority])
2. **[task-id]** - [Title] (P[priority])
### Git State
- Branch: [branch]
- Uncommitted: [X files or clean]
### Scope Reminder
Focus on: [primary goal]
Avoid: [main scope creep risk]
---
**Which task would you like to work on?**WAIT for user response before starting work.
---
If No Recovery File
Fallback process: 1. Read CLAUDE.md for project overview 2. Read MEMORY.md for architecture patterns 3. Run bd list to see all work 4. Check git log for recent activity 5. Ask user what to work on