# Claude Conversation Manager Usage

## Quickstart

```bash
npm install -g claude-conversation-manager
cd your-project
ccm memory build
ccm memory handoff
```

`ccm memory build` scans Claude Code sessions for the current project and writes local memory to `.claude-memory/memory.json` plus a readable handoff to `.claude-memory/handoff.md`.

## Memory Workflow

```bash
ccm memory init
ccm memory build
ccm memory search "parser"
ccm memory recall "what did we decide about JSONL repair?"
ccm memory handoff
```

- Use `build` after meaningful Claude Code work.
- Use `search` for exact keywords such as files, tasks, or issue names.
- Use `recall` for lightweight local similarity across captured decisions, tasks, files, and issues.
- Use `handoff` before a new session or after context compaction.

No cloud API is required for memory recall.

## Legacy Cleanup Commands

```bash
ccm list
ccm search "keyword"
ccm delete
ccm delete --corrupted
ccm health
ccm health --fix
ccm interactive
```

Common cleanup flow:

```bash
ccm health
ccm list --corrupted
ccm delete --corrupted
```

Cleanup commands are designed to be cautious: deletion asks for confirmation, and backups are enabled by default unless you pass `--no-backup`.

Manual backup is available from `ccm interactive`.