Make Claude Code remember. Sessions that persist, tasks that finish, context that never dies.
Claude Code is powerful — but stateless. Every session starts from zero.
- Yesterday's progress? Gone. No memory of what was discussed, decided, or built.
- Task tracking across sessions? Manual copy-paste into prompts.
- Repetitive workflows? Type the same instructions every time.
- Token budget? Runs out silently. Context collapses without warning.
Claude Code out of the box is a brilliant engineer with amnesia.
claude-persist makes Claude Code sessions continuous. Install once, benefit in every project.
Sessions write structured handoffs. The next session picks up exactly where you left off — decisions, progress, blockers, learnings. No re-explaining.
UUID-based task tracking with dependency resolution, sub-agent delegation, and automatic checkpoint commits. A project manager that lives inside your terminal.
From project scaffolding to prompt optimization, from documentation restructuring to Obsidian vault integration. Each skill replaces 10-15 minutes of manual prompting.
Proactive monitoring prevents context collapse. Automatic documentation refresh before you hit the limit.
| Component | Count | Highlights |
|---|---|---|
| Skills | 19 | session-refresh, task-orchestrator, vault-manager, prompt-improver, project-init |
| Commands | 6 | /run-next-tasks, /obsidian-sync, /vault-export, /sync-claude-persist |
| Hooks | 4 | Session handoff loader, notification system, tool-call logger |
| Agents | 1 | Setup guide agent for self-documentation |
| Output Styles | 1 | Executive communication mode (German/English) |
| Plugins | 14 | code-review, commit-commands, hookify, pr-review-toolkit, feature-dev |
1. Claude reads CLAUDE.md + PROJEKT.md (automatic)
2. /run-next-tasks → identifies ready tasks
3. Start working — full context from previous session loaded
1. Final commit with descriptive message
2. Session handoff written (progress, blockers, recommendations)
3. Documentation refresh if token budget > 65%
Create → Schedule → Execute (with sub-agents) → Checkpoint → Complete
↑ |
└──────────────────────────────────────────────────────┘
Dependencies resolve automatically
# Clone into ~/.claude/
git clone https://github.com/jopre0502/claude-persist.git ~/.claude/
# That's it. Claude Code auto-discovers everything from ~/.claude/Already have
~/.claude/? Back it up first — this repo replaces the entire directory.
- Claude Code CLI (latest)
- Bash >= 4.0 (macOS:
brew install bash) - Git >= 2.30
- Optional: Obsidian for vault integration
- Optional: 1Password CLI for secrets management
| Skill | What it does |
|---|---|
session-refresh |
Updates project docs, triggers restructuring, manages token budget |
task-orchestrator |
Executes tasks with sub-agent delegation and checkpoint commits |
task-scheduler |
Resolves dependencies, identifies which tasks are ready |
vault-manager |
Read-only Obsidian Vault access via vault: prefix notation |
project-init |
One-command project scaffolding with full session-continuous infrastructure |
prompt-improver |
Analyzes and improves prompts following Anthropic best practices |
skill-creator |
Guided skill creation with validation and best-practice enforcement |
prioritize-tasks |
Scores tasks by dependencies, effort, and blockers |
View all skills and commands →
~/.claude/
├── CLAUDE.md # Global instructions (loaded every session)
├── skills/ # 20+ automation skills
├── agents/ # Autonomous agents
├── commands/ # Slash commands (/run-next-tasks, etc.)
├── hooks/ # Event-driven automation
├── output-styles/ # Communication modes
├── projects/ # Per-project memory (handoffs, decisions)
├── plugins/ # Installed plugins
└── settings.json # Permissions and auto-approval rules
Each project gets its own session-continuous setup via /project-init:
your-project/
├── CLAUDE.md # Project-specific instructions
├── PROJEKT.md # Task tracking (7-column schema)
└── docs/
├── tasks/ # Individual task files with audit trail
├── handoffs/ # Session handoff history
└── DECISION-LOG.md # Architectural decisions
- Persist over Reset — Every session builds on the last
- Convention over Configuration — Works out of the box, customizable when needed
- Automation over Repetition — If you do it twice, make it a skill
- Transparency over Magic — Every decision logged, every action traceable
- Cross-Platform — Windows (Git Bash) and macOS, OS-detection built in
See CONTRIBUTING.md for branch strategy, commit conventions, and how to add new skills, commands, or hooks.
See SECURITY.md for vulnerability reporting and security best practices.
MIT License — see LICENSE for details.
Built with Claude Code. Powered by persistence.