{"id":39861932,"url":"https://github.com/bokiko/continuous-claude-guide","last_synced_at":"2026-01-18T14:00:55.638Z","repository":{"id":331379054,"uuid":"1126398403","full_name":"bokiko/continuous-claude-guide","owner":"bokiko","description":"Give Claude Code a memory. Pick up where you left off, every time.","archived":false,"fork":false,"pushed_at":"2026-01-17T23:09:50.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T12:03:18.914Z","etag":null,"topics":["ai-agents","claude","claude-ai","claude-code","claude-desktop"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bokiko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T20:38:17.000Z","updated_at":"2026-01-17T23:09:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bokiko/continuous-claude-guide","commit_stats":null,"previous_names":["bokiko/continuous-claude-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bokiko/continuous-claude-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fcontinuous-claude-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fcontinuous-claude-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fcontinuous-claude-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fcontinuous-claude-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bokiko","download_url":"https://codeload.github.com/bokiko/continuous-claude-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bokiko%2Fcontinuous-claude-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28537483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T13:04:05.990Z","status":"ssl_error","status_checked_at":"2026-01-18T13:01:44.092Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude","claude-ai","claude-code","claude-desktop"],"created_at":"2026-01-18T14:00:50.826Z","updated_at":"2026-01-18T14:00:55.540Z","avatar_url":"https://github.com/bokiko.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Continuous-Claude\n\n\u003ch3\u003eGive Claude Code a memory. Pick up where you left off, every time.\u003c/h3\u003e\n\n\u003cp\u003e\n  \u003ca href=\"#quick-start\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/setup-10%20minutes-success\" alt=\"10 min setup\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/AnandChowdhary/continuous-claude\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/based%20on-Continuous--Claude-blue\" alt=\"Based on Continuous-Claude\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/bokiko/continuous-claude-guide/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"MIT License\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://bokiko.io\"\u003ebokiko.io\u003c/a\u003e · \u003ca href=\"https://twitter.com/bokiko\"\u003e@bokiko\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n## Table of Contents\n\n1. [The Problem](#the-problem)\n2. [The Solution](#the-solution)\n3. [Who is this for?](#who-is-this-for)\n4. [How it works](#how-it-works-simple-version)\n5. [Quick Start](#quick-start) (Let Claude install it for you!)\n6. [Manual Installation](#manual-installation) (macOS, Ubuntu, Fedora)\n7. [Commands Reference](#commands-reference)\n8. [Companion Tools](#companion-tools)\n9. [Custom Statusline](#custom-statusline)\n10. [FAQ](#faq)\n11. [Troubleshooting](#troubleshooting)\n12. [Credits](#credits)\n\n---\n\n## The Problem\n\nEvery time you close Claude Code, it forgets everything. Your progress, your decisions, the context you spent 30 minutes building up - gone.\n\n**Sound familiar?**\n- \"Wait, what were we working on yesterday?\"\n- \"I already explained this architecture to you...\"\n- \"Can you remember what we decided about the database?\"\n\nClaude Code is stateless by default. Each session starts fresh. That's fine for quick questions, but terrible for real work.\n\n---\n\n## The Solution\n\n**Continuous-Claude** gives Claude Code persistent memory through:\n\n| Feature | What it does |\n|---------|--------------|\n| **Continuity Ledger** | Tracks your session state, goals, and progress |\n| **Handoffs** | Saves your work so you can continue later |\n| **Session Tracing** | Logs your sessions for analysis (optional) |\n| **Auto-Learnings** | Extracts insights to improve future sessions |\n| **Extra Tools** | Web search, code quality checks, and more |\n\n**The result?** Claude remembers what you were working on, what decisions you made, and where you left off.\n\n---\n\n## Who is this for?\n\n| If you're... | Continuous-Claude helps you... |\n|--------------|-------------------------------|\n| **Using Claude Code daily** | Stop re-explaining context every session |\n| **Working on long projects** | Maintain progress across days/weeks |\n| **Managing infrastructure** | Keep runbooks and system knowledge available |\n| **Doing complex refactors** | Track multi-step plans without losing state |\n| **New to Claude Code** | Build good habits from day one |\n\n---\n\n## How it works (simple version)\n\n**Without Continuous-Claude:**\n```\nDay 1: \"Let's refactor the auth system\"\n       [Claude learns your codebase, makes progress]\n       [Session ends]\n\nDay 2: \"Continue the auth refactor\"\n       Claude: \"I don't have any context about an auth refactor.\n                Could you explain what you're working on?\"\n       [Start over from scratch]\n```\n\n**With Continuous-Claude:**\n```\nDay 1: \"Let's refactor the auth system\"\n       [Claude learns your codebase, makes progress]\n       [You type: /create_handoff]\n       [Session ends]\n\nDay 2: \"Continue the auth refactor\"\n       [You type: /resume_handoff]\n       Claude: \"I see we completed the JWT migration yesterday.\n                Next up is updating the middleware. Ready?\"\n       [Continue where you left off]\n```\n\n---\n\n## Quick Start\n\n### The Easy Way (Recommended)\n\n**Let Claude handle the entire setup for you!** This is the smoothest experience - Claude will install everything, configure it, and verify it works.\n\nCopy and paste this prompt to Claude:\n\n```\nI'd like you to set up Continuous-Claude for my Claude Code environment.\n\nPlease:\n1. Check my OS (macOS/Ubuntu/Fedora) and install any missing prerequisites\n2. Clone and install Continuous-Claude from https://github.com/parcadei/Continuous-Claude\n3. Run the global installer (install-global.sh)\n4. Configure with minimal settings (TRACE_TO_BRAINTRUST=\"false\")\n5. Create a workspace at /opt/claude-admin and initialize it\n6. Add a convenient alias to my shell config\n7. Verify everything is working\n8. Give me a quick summary of what was set up and the commands I can use\n\nStart by checking what's already installed on my system.\n```\n\nClaude will:\n- Detect your operating system\n- Install missing dependencies (node, python, git, etc.)\n- Clone and configure Continuous-Claude\n- Set up your workspace\n- Verify the installation works\n- Teach you the basic commands\n\n**That's the recommended approach!** Claude handles all the technical details.\n\n---\n\n## Manual Installation\n\nIf you prefer to control every step, expand your OS below:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003emacOS Installation\u003c/strong\u003e\u003c/summary\u003e\n\n### Prerequisites\n\n```bash\n# Install Homebrew if not installed\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n\n# Install required packages\nbrew install node python@3.12 git jq\n\n# Verify installations\nnode --version    # Should be 18+\npython3 --version # Should be 3.11+\n```\n\n### Install Continuous-Claude\n\n```bash\n# Clone the repository\nmkdir -p ~/Documents/github \u0026\u0026 cd ~/Documents/github\ngit clone https://github.com/parcadei/Continuous-Claude.git\ncd Continuous-Claude\n\n# Install uv (Python package manager)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nsource ~/.zshrc\n\n# Run the installer\n./install-global.sh\n\n# Configure (minimal - no external services)\necho 'TRACE_TO_BRAINTRUST=\"false\"' \u003e ~/.claude/.env\n```\n\n### Set Up Your Workspace\n\n```bash\n# Create workspace\nsudo mkdir -p /opt/claude-admin\nsudo chown $(whoami):staff /opt/claude-admin\n\n# Initialize project\ncd /opt/claude-admin\n~/.claude/scripts/init-project.sh\n\n# Add quick-start alias\necho 'alias sysadmin=\"cd /opt/claude-admin \u0026\u0026 claude\"' \u003e\u003e ~/.zshrc\nsource ~/.zshrc\n```\n\n### Start Using\n\n```bash\nsysadmin\n# Then inside Claude: /continuity_ledger\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eUbuntu Installation\u003c/strong\u003e\u003c/summary\u003e\n\n### Prerequisites\n\n```bash\n# Update and install required packages\nsudo apt update\nsudo apt install -y git curl sqlite3 jq python3 python3-venv python3-pip\n\n# Install Node.js 20\ncurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -\nsudo apt-get install -y nodejs\n\n# Verify installations\nnode --version    # Should be 18+\npython3 --version # Should be 3.11+\n```\n\n### Install Continuous-Claude\n\n```bash\n# Clone the repository\nmkdir -p ~/projects \u0026\u0026 cd ~/projects\ngit clone https://github.com/parcadei/Continuous-Claude.git\ncd Continuous-Claude\n\n# Install uv (Python package manager)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nsource ~/.bashrc\n\n# Run the installer\n./install-global.sh\n\n# Configure (minimal - no external services)\necho 'TRACE_TO_BRAINTRUST=\"false\"' \u003e ~/.claude/.env\n```\n\n### Set Up Your Workspace\n\n```bash\n# Create workspace\nsudo mkdir -p /opt/claude-admin\nsudo chown $(whoami):$(whoami) /opt/claude-admin\n\n# Initialize project\ncd /opt/claude-admin\n~/.claude/scripts/init-project.sh\n\n# Add quick-start alias\necho 'alias sysadmin=\"cd /opt/claude-admin \u0026\u0026 claude\"' \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n### Start Using\n\n```bash\nsysadmin\n# Then inside Claude: /continuity_ledger\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFedora Installation\u003c/strong\u003e\u003c/summary\u003e\n\n### Prerequisites\n\n```bash\n# Install required packages\nsudo dnf install -y git curl sqlite jq python3 python3-pip nodejs\n\n# Verify installations\nnode --version    # Should be 18+\npython3 --version # Should be 3.11+\n```\n\n### Install Continuous-Claude\n\n```bash\n# Clone the repository\nmkdir -p ~/projects \u0026\u0026 cd ~/projects\ngit clone https://github.com/parcadei/Continuous-Claude.git\ncd Continuous-Claude\n\n# Install uv (Python package manager)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nsource ~/.bashrc\n\n# Run the installer\n./install-global.sh\n\n# Configure (minimal - no external services)\necho 'TRACE_TO_BRAINTRUST=\"false\"' \u003e ~/.claude/.env\n```\n\n### Set Up Your Workspace\n\n```bash\n# Create workspace\nsudo mkdir -p /opt/claude-admin\nsudo chown $(whoami):$(whoami) /opt/claude-admin\n\n# Initialize project\ncd /opt/claude-admin\n~/.claude/scripts/init-project.sh\n\n# Add quick-start alias\necho 'alias sysadmin=\"cd /opt/claude-admin \u0026\u0026 claude\"' \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n### Start Using\n\n```bash\nsysadmin\n# Then inside Claude: /continuity_ledger\n```\n\n\u003c/details\u003e\n\n---\n\n## Requirements\n\n| Requirement | Version | Check command |\n|------------|---------|---------------|\n| Claude Code CLI | Any | `claude --version` |\n| Node.js | 18+ | `node --version` |\n| Python | 3.11+ | `python3 --version` |\n| Git | Any | `git --version` |\n| SQLite3 | Any | `sqlite3 --version` |\n| jq | Any | `jq --version` |\n| curl | Any | `curl --version` |\n\n**Important:**\n- Works with: **Claude Code CLI** (terminal command `claude`)\n- Does NOT work with: Cursor IDE, VS Code extensions\n\n---\n\n## Commands Reference\n\n### Core Commands\n\n| Command | What It Does |\n|---------|--------------|\n| `/continuity_ledger` | Create/update your session ledger |\n| `/create_handoff` | Save your work for later |\n| `/resume_handoff` | Continue from last session |\n| `/create_plan` | Create an implementation plan |\n| `/implement_plan` | Execute a plan step by step |\n\n### Other Useful Commands\n\n| Command | What It Does |\n|---------|--------------|\n| `/commit` | Create a git commit |\n| `/debug` | Debug an issue systematically |\n| `/qlty-check` | Run code quality checks |\n\n---\n\n## Companion Tools\n\n### BloxCue - Reduce Token Usage by 90%\n\nOnce you have Continuous-Claude set up, add [**BloxCue**](https://github.com/bokiko/bloxcue) to dramatically reduce your token usage.\n\n| Problem | Solution |\n|---------|----------|\n| Large CLAUDE.md files load on every prompt | BloxCue loads only relevant context blocks |\n| ~8,500 tokens wasted per prompt | ~800 tokens loaded (only what's needed) |\n| Hit token limits faster | Save ~7,000+ tokens per prompt |\n\n**Quick Install:**\n```bash\ngit clone https://github.com/bokiko/bloxcue.git\ncd bloxcue\n./install.sh\n```\n\nOr just tell Claude: *\"Install BloxCue for me from github.com/bokiko/bloxcue\"*\n\n---\n\n## Custom Statusline\n\nUpgrade from plain text to a visual progress bar.\n\n| Default | Custom |\n|---------|--------|\n| `83.9k 41%` | `[██████░░░░░░░░░] 41%` |\n\n**Features:**\n- Visual progress bar instead of plain numbers\n- Color-coded warnings (green \u003c 60%, yellow 60-79%, red 80%+)\n- Git status: branch + staged/unstaged counts\n- Continuity ledger: last completed task → current focus\n\n**Install:**\n```bash\ncurl -o ~/.claude/scripts/status.sh \\\n  \"https://gitlab.com/bokiko/continuous-claude-guide/-/raw/main/scripts/statusline/claude-statusline.sh\"\nchmod +x ~/.claude/scripts/status.sh\n```\n\nAdd to `~/.claude/settings.json`:\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"$HOME/.claude/scripts/status.sh\"\n  }\n}\n```\n\n---\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDoes this work with Cursor or VS Code extensions?\u003c/strong\u003e\u003c/summary\u003e\n\nNo. This is designed for **Claude Code CLI** (the terminal tool). The hooks and skills system only works with the CLI.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat's the difference between ledgers and handoffs?\u003c/strong\u003e\u003c/summary\u003e\n\n- **Ledger**: A living document that tracks your current session state, goals, and progress. Updated as you work.\n- **Handoff**: A snapshot saved when you're done working. Used to resume later with full context.\n\nThink of ledgers as \"what I'm doing now\" and handoffs as \"what I was doing when I stopped.\"\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDo I need external services like Braintrust?\u003c/strong\u003e\u003c/summary\u003e\n\nNo. The minimal config (`TRACE_TO_BRAINTRUST=\"false\"`) works completely offline. Braintrust is optional for session analytics.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I use this for multiple projects?\u003c/strong\u003e\u003c/summary\u003e\n\nYes! Each project gets its own `thoughts/` directory with separate ledgers and handoffs. Initialize each project with `~/.claude/scripts/init-project.sh`.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat if I forget to create a handoff?\u003c/strong\u003e\u003c/summary\u003e\n\nThe 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.\n\u003c/details\u003e\n\n---\n\n## Troubleshooting\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\"Command not found: claude\"\u003c/strong\u003e\u003c/summary\u003e\n\nClaude Code CLI is not installed. Get it from: https://docs.anthropic.com/claude-code\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\"Command not found: uv\"\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nexport PATH=\"$HOME/.local/bin:$PATH\"\n# Add to ~/.bashrc or ~/.zshrc for permanence\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\"No ledger found\" warning\u003c/strong\u003e\u003c/summary\u003e\n\nInitialize your project:\n```bash\ncd /your/project/path\n~/.claude/scripts/init-project.sh\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\"Permission denied\" errors\u003c/strong\u003e\u003c/summary\u003e\n\nmacOS:\n```bash\nsudo chown -R $(whoami):staff /opt/claude-admin\n```\n\nUbuntu/Fedora:\n```bash\nsudo chown -R $(whoami):$(whoami) /opt/claude-admin\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHooks not executing\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nchmod +x ~/.claude/hooks/*.sh\n```\n\u003c/details\u003e\n\n---\n\n## File Locations\n\n| What | Location |\n|------|----------|\n| Global installation | `~/.claude/` |\n| Configuration | `~/.claude/.env` |\n| Hooks | `~/.claude/hooks/` |\n| Skills | `~/.claude/skills/` |\n| Project ledgers | `your-project/thoughts/ledgers/` |\n| Project handoffs | `your-project/thoughts/shared/handoffs/` |\n\n---\n\n## Credits\n\n- [parcadei](https://github.com/parcadei) - Creator of [Continuous-Claude-V3](https://github.com/parcadei/Continuous-Claude-v3)\n\n---\n\n## License\n\nMIT - Use it however you want.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade by [@bokiko](https://twitter.com/bokiko) · [bokiko.io](https://bokiko.io)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbokiko%2Fcontinuous-claude-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbokiko%2Fcontinuous-claude-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbokiko%2Fcontinuous-claude-guide/lists"}