cc-os/README.md

# cc-os — Cross-Project Memory for Claude Code

A personal memory system for Claude Code, designed for a multi-client freelancer.
The system captures knowledge across projects and surfaces it automatically at the
start of each Claude Code session.

## Status

The memory plugin is **live and working.** Design documentation lives in `docs/`.
Both episodic memory (memsearch) and semantic/knowledge memory (Graphify + Obsidian vault)
are active.

## What it does for you

- **Injects vault context at session start** — Claude sees your SecondBrain graph
  summary, your conventions, and today's journal path before you type the first message.
- **Surfaces project structure on demand** — run one command to build a graph of any
  project; Claude can then query it for patterns, architecture, and conventions.
- **Remembers conventions automatically** — `memory-write` stores evergreen knowledge
  (coding patterns, client rules, recurring decisions) in the correct vault location
  with proper tags.
- **Stays fresh without a daemon** — the vault graph rebuilds in the background when
  stale; vault writes immediately invalidate the timestamp so the next session picks
  up changes.
- **Keeps project repos clean** — all indexes are build artifacts (`graphify-out/`);
  nothing is committed to project repos.

## User guide

See **[docs/USER-GUIDE.md](docs/USER-GUIDE.md)** for setup, onboarding new projects,
using the skills, and known limitations.

## Directory layout

| Path | Contents |
|------|----------|
| `docs/memory-system/` | Architecture, ADRs, build plan, Graphify evaluation |
| `docs/graphify/` | Verified Graphify command handbook |
| `docs/USER-GUIDE.md` | Practical usage guide |
| `openspec/` | Spec-driven change management (changes, specs) |
| `graphify-interview`, `memory-systems-compared060326` | Raw source transcripts (do not cite as fact) |