No description
Find a file
2026-01-15 07:21:08 -08:00
bin chore: 🔧 Update files 2026-01-15 06:19:57 -08:00
package.json chore: 🔧 Update files 2026-01-15 07:21:08 -08:00
README.md feat: initial claude-continue CLI package 2026-01-10 10:39:51 -08:00

@lilith/claude-continue

Smart tmux wrapper for Claude Code with crash recovery and LLM-powered task review.

Features

  • Terminal crash resilience: Claude runs in tmux, survives terminal crashes
  • Smart session management: One session per directory, auto-attach/create
  • LLM-powered task review: Analyzes saved tasks, categorizes as ACTIVE/COOLING/STALE
  • Handoff generation: Creates context-rich handoff files for session resumption

Installation

# Link to local bin
ln -sf ~/Code/@packages/@cli/claude-continue/bin/cc ~/.local/bin/cc

Usage

cc                     # Start/attach claude for current directory
cc status              # Show session status for current directory
cc list                # Show all sessions with directories
cc tasks               # Show persisted tasks with prompts
cc review              # LLM-analyze tasks (run after reboot)
cc resume [n]          # Show/resume reviewed tasks
cc kill                # Kill session for current directory
cc help                # Show all commands

Recovery Workflow

After system crash/reboot:

cc review              # LLM analyzes all tasks, categorizes them
cc resume              # Shows: ACTIVE, COOLING, STALE tasks
cc resume 1            # Creates handoff, shows paste instruction

Then:

cd <project-directory>
cc
# Paste: "Read the handoff at .claude/handoffs/<timestamp>_<name>.md and continue the work"

Session Management

Sessions are named by directory: claude-<hash>-<dirname>

cc list                # See all running sessions
cc attach <name>       # Attach to specific session
cc kill <name>         # Kill specific session

Task Categories

After cc review:

Status Meaning Action
ACTIVE Recent (<4h), incomplete Resume immediately
COOLING Paused (4-24h), waiting Can resume
STALE Old (>24h) or complete Archive/ignore

tmux Keybindings

Key Action
Ctrl+B D Detach (keeps claude running)
Ctrl+B [ Enter scroll mode

Files

Location Purpose
~/.local/claude/tasks/ Saved task prompts
~/.local/claude/reviews/ LLM-generated reviews
<project>/.claude/handoffs/ Handoff files for resumption