Continuous-Claude

Give Claude Code a memory. Pick up where you left off, every time.

The Problem

Every time you close Claude Code, it forgets everything. Your progress, your decisions, the context you spent 30 minutes building up - gone.

Sound familiar?

"Wait, what were we working on yesterday?"
"I already explained this architecture to you..."
"Can you remember what we decided about the database?"

Claude Code is stateless by default. Each session starts fresh. That's fine for quick questions, but terrible for real work.

The Solution

Continuous-Claude gives Claude Code persistent memory through:

Feature	What it does
Continuity Ledger	Tracks your session state, goals, and progress
Handoffs	Saves your work so you can continue later
Session Tracing	Logs your sessions for analysis (optional)
Auto-Learnings	Extracts insights to improve future sessions
Extra Tools	Web search, code quality checks, and more

The result? Claude remembers what you were working on, what decisions you made, and where you left off.

Who is this for?

If you're...	Continuous-Claude helps you...
Using Claude Code daily	Stop re-explaining context every session
Working on long projects	Maintain progress across days/weeks
Managing infrastructure	Keep runbooks and system knowledge available
Doing complex refactors	Track multi-step plans without losing state
New to Claude Code	Build good habits from day one

How it works (simple version)

Without Continuous-Claude:

Day 1: "Let's refactor the auth system"
       [Claude learns your codebase, makes progress]
       [Session ends]

Day 2: "Continue the auth refactor"
       Claude: "I don't have any context about an auth refactor.
                Could you explain what you're working on?"
       [Start over from scratch]

With Continuous-Claude:

Day 1: "Let's refactor the auth system"
       [Claude learns your codebase, makes progress]
       [You type: /create_handoff]
       [Session ends]

Day 2: "Continue the auth refactor"
       [You type: /resume_handoff]
       Claude: "I see we completed the JWT migration yesterday.
                Next up is updating the middleware. Ready?"
       [Continue where you left off]

Quick Start

The Easy Way (Recommended)

Let Claude handle the entire setup for you! This is the smoothest experience - Claude will install everything, configure it, and verify it works.

Copy and paste this prompt to Claude:

I'd like you to set up Continuous-Claude for my Claude Code environment.

Please:
1. Check my OS (macOS/Ubuntu/Fedora) and install any missing prerequisites
2. Clone and install Continuous-Claude from https://github.com/parcadei/Continuous-Claude
3. Run the global installer (install-global.sh)
4. Configure with minimal settings (TRACE_TO_BRAINTRUST="false")
5. Create a workspace at /opt/claude-admin and initialize it
6. Add a convenient alias to my shell config
7. Verify everything is working
8. Give me a quick summary of what was set up and the commands I can use

Start by checking what's already installed on my system.

Claude will:

Detect your operating system
Install missing dependencies (node, python, git, etc.)
Clone and configure Continuous-Claude
Set up your workspace
Verify the installation works
Teach you the basic commands

That's the recommended approach! Claude handles all the technical details.

Manual Installation

If you prefer to control every step, expand your OS below:

macOS Installation

Prerequisites

# Install Homebrew if not installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install required packages
brew install node python@3.12 git jq

# Verify installations
node --version    # Should be 18+
python3 --version # Should be 3.11+

Install Continuous-Claude

# Clone the repository
mkdir -p ~/Documents/github && cd ~/Documents/github
git clone https://github.com/parcadei/Continuous-Claude.git
cd Continuous-Claude

# Install uv (Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.zshrc

# Run the installer
./install-global.sh

# Configure (minimal - no external services)
echo 'TRACE_TO_BRAINTRUST="false"' > ~/.claude/.env

Set Up Your Workspace

# Create workspace
sudo mkdir -p /opt/claude-admin
sudo chown $(whoami):staff /opt/claude-admin

# Initialize project
cd /opt/claude-admin
~/.claude/scripts/init-project.sh

# Add quick-start alias
echo 'alias sysadmin="cd /opt/claude-admin && claude"' >> ~/.zshrc
source ~/.zshrc

Start Using

sysadmin
# Then inside Claude: /continuity_ledger

Ubuntu Installation

Prerequisites

# Update and install required packages
sudo apt update
sudo apt install -y git curl sqlite3 jq python3 python3-venv python3-pip

# Install Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Verify installations
node --version    # Should be 18+
python3 --version # Should be 3.11+

Install Continuous-Claude

# Clone the repository
mkdir -p ~/projects && cd ~/projects
git clone https://github.com/parcadei/Continuous-Claude.git
cd Continuous-Claude

# Install uv (Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# Run the installer
./install-global.sh

# Configure (minimal - no external services)
echo 'TRACE_TO_BRAINTRUST="false"' > ~/.claude/.env

Set Up Your Workspace

# Create workspace
sudo mkdir -p /opt/claude-admin
sudo chown $(whoami):$(whoami) /opt/claude-admin

# Initialize project
cd /opt/claude-admin
~/.claude/scripts/init-project.sh

# Add quick-start alias
echo 'alias sysadmin="cd /opt/claude-admin && claude"' >> ~/.bashrc
source ~/.bashrc

Start Using

sysadmin
# Then inside Claude: /continuity_ledger

Fedora Installation

Prerequisites

# Install required packages
sudo dnf install -y git curl sqlite jq python3 python3-pip nodejs

# Verify installations
node --version    # Should be 18+
python3 --version # Should be 3.11+

Install Continuous-Claude

# Clone the repository
mkdir -p ~/projects && cd ~/projects
git clone https://github.com/parcadei/Continuous-Claude.git
cd Continuous-Claude

# Install uv (Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# Run the installer
./install-global.sh

# Configure (minimal - no external services)
echo 'TRACE_TO_BRAINTRUST="false"' > ~/.claude/.env

Set Up Your Workspace

# Create workspace
sudo mkdir -p /opt/claude-admin
sudo chown $(whoami):$(whoami) /opt/claude-admin

# Initialize project
cd /opt/claude-admin
~/.claude/scripts/init-project.sh

# Add quick-start alias
echo 'alias sysadmin="cd /opt/claude-admin && claude"' >> ~/.bashrc
source ~/.bashrc

Start Using

sysadmin
# Then inside Claude: /continuity_ledger

Requirements

Requirement	Version	Check command
Claude Code CLI	Any	`claude --version`
Node.js	18+	`node --version`
Python	3.11+	`python3 --version`
Git	Any	`git --version`
SQLite3	Any	`sqlite3 --version`
jq	Any	`jq --version`
curl	Any	`curl --version`

Important:

Works with: Claude Code CLI (terminal command claude)
Does NOT work with: Cursor IDE, VS Code extensions

Commands Reference

Core Commands

Command	What It Does
`/continuity_ledger`	Create/update your session ledger
`/create_handoff`	Save your work for later
`/resume_handoff`	Continue from last session
`/create_plan`	Create an implementation plan
`/implement_plan`	Execute a plan step by step

Other Useful Commands

Command	What It Does
`/commit`	Create a git commit
`/debug`	Debug an issue systematically
`/qlty-check`	Run code quality checks

Companion Tools

BloxCue - Reduce Token Usage by 90%

Once you have Continuous-Claude set up, add BloxCue to dramatically reduce your token usage.

Problem	Solution
Large CLAUDE.md files load on every prompt	BloxCue loads only relevant context blocks
~8,500 tokens wasted per prompt	~800 tokens loaded (only what's needed)
Hit token limits faster	Save ~7,000+ tokens per prompt

Quick Install:

git clone https://github.com/bokiko/bloxcue.git
cd bloxcue
./install.sh

Or just tell Claude: "Install BloxCue for me from github.com/bokiko/bloxcue"

Custom Statusline

Upgrade from plain text to a visual progress bar.

Default	Custom
`83.9k 41%`	`[██████░░░░░░░░░] 41%`

Features:

Visual progress bar instead of plain numbers
Color-coded warnings (green < 60%, yellow 60-79%, red 80%+)
Git status: branch + staged/unstaged counts
Continuity ledger: last completed task → current focus

Install:

curl -o ~/.claude/scripts/status.sh \
  "https://gitlab.com/bokiko/continuous-claude-guide/-/raw/main/scripts/statusline/claude-statusline.sh"
chmod +x ~/.claude/scripts/status.sh

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "$HOME/.claude/scripts/status.sh"
  }
}

FAQ

Does this work with Cursor or VS Code extensions?

No. This is designed for Claude Code CLI (the terminal tool). The hooks and skills system only works with the CLI.

What's the difference between ledgers and handoffs?

Ledger: A living document that tracks your current session state, goals, and progress. Updated as you work.
Handoff: A snapshot saved when you're done working. Used to resume later with full context.

Think of ledgers as "what I'm doing now" and handoffs as "what I was doing when I stopped."

Do I need external services like Braintrust?

No. The minimal config (TRACE_TO_BRAINTRUST="false") works completely offline. Braintrust is optional for session analytics.

Can I use this for multiple projects?

Yes! Each project gets its own thoughts/ directory with separate ledgers and handoffs. Initialize each project with ~/.claude/scripts/init-project.sh.

What if I forget to create a handoff?

The ledger still captures your progress. It won't be as detailed as a handoff, but Claude can read the ledger to understand what you were working on.

Troubleshooting

"Command not found: claude"

Claude Code CLI is not installed. Get it from: https://docs.anthropic.com/claude-code

"Command not found: uv"

curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
# Add to ~/.bashrc or ~/.zshrc for permanence

"No ledger found" warning

Initialize your project:

cd /your/project/path
~/.claude/scripts/init-project.sh

"Permission denied" errors

macOS:

sudo chown -R $(whoami):staff /opt/claude-admin

Ubuntu/Fedora:

sudo chown -R $(whoami):$(whoami) /opt/claude-admin

Hooks not executing

chmod +x ~/.claude/hooks/*.sh

File Locations

What	Location
Global installation	`~/.claude/`
Configuration	`~/.claude/.env`
Hooks	`~/.claude/hooks/`
Skills	`~/.claude/skills/`
Project ledgers	`your-project/thoughts/ledgers/`
Project handoffs	`your-project/thoughts/shared/handoffs/`

Credits

parcadei - Creator of Continuous-Claude-V3

License

MIT - Use it however you want.

Made by @bokiko · bokiko.io

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
.github/workflows		.github/workflows
scripts/statusline		scripts/statusline
.gitlab-ci.yml		.gitlab-ci.yml
README.md		README.md

bokiko/continuous-claude-guide

Folders and files

Latest commit

History

Repository files navigation

Continuous-Claude

Give Claude Code a memory. Pick up where you left off, every time.

Table of Contents

The Problem

The Solution

Who is this for?

How it works (simple version)

Quick Start

The Easy Way (Recommended)

Manual Installation

Prerequisites

Install Continuous-Claude

Set Up Your Workspace

Start Using

Prerequisites

Install Continuous-Claude

Set Up Your Workspace

Start Using

Prerequisites

Install Continuous-Claude

Set Up Your Workspace

Start Using

Requirements

Commands Reference

Core Commands

Other Useful Commands

Companion Tools

BloxCue - Reduce Token Usage by 90%

Custom Statusline

FAQ

Troubleshooting

File Locations

Credits

License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages