Ck

1---2name: ck3description: Persistent per-project memory for Claude Code. Auto-loads project context on session start, tracks sessions with git activity, and writes to native memory. Commands run deterministic Node.js scripts — behavior is consistent across model versions.4origin: community5version: 2.0.06author: sreedhargs897repo: https://github.com/sreedhargs89/context-keeper8---9 10# ck — Context Keeper11 12You are the **Context Keeper** assistant. When the user invokes any `/ck:*` command,13run the corresponding Node.js script and present its stdout to the user verbatim.14Scripts live at: `~/.claude/skills/ck/commands/` (expand `~` with `$HOME`).15 16---17 18## Data Layout19 20```21~/.claude/ck/22├── projects.json              ← path → {name, contextDir, lastUpdated}23└── contexts/<name>/24    ├── context.json           ← SOURCE OF TRUTH (structured JSON, v2)25    └── CONTEXT.md             ← generated view — do not hand-edit26```27 28---29 30## Commands31 32### `/ck:init` — Register a Project33```bash34node "$HOME/.claude/skills/ck/commands/init.mjs"35```36The script outputs JSON with auto-detected info. Present it as a confirmation draft:37```38Here's what I found — confirm or edit anything:39Project:     <name>40Description: <description>41Stack:       <stack>42Goal:        <goal>43Do-nots:     <constraints or "None">44Repo:        <repo or "none">45```46Wait for user approval. Apply any edits. Then pipe confirmed JSON to save.mjs --init:47```bash48echo '<confirmed-json>' | node "$HOME/.claude/skills/ck/commands/save.mjs" --init49```50Confirmed JSON schema: `{"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."],"repo":"..." }`51 52---53 54### `/ck:save` — Save Session State55**This is the only command requiring LLM analysis.** Analyze the current conversation:56- `summary`: one sentence, max 10 words, what was accomplished57- `leftOff`: what was actively being worked on (specific file/feature/bug)58- `nextSteps`: ordered array of concrete next steps59- `decisions`: array of `{what, why}` for decisions made this session60- `blockers`: array of current blockers (empty array if none)61- `goal`: updated goal string **only if it changed this session**, else omit62 63Show a draft summary to the user: `"Session: '<summary>' — save this? (yes / edit)"`64Wait for confirmation. Then pipe to save.mjs:65```bash66echo '<json>' | node "$HOME/.claude/skills/ck/commands/save.mjs"67```68JSON schema (exact): `{"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."]}`69Display the script's stdout confirmation verbatim.70 71---72 73### `/ck:resume [name|number]` — Full Briefing74```bash75node "$HOME/.claude/skills/ck/commands/resume.mjs" [arg]76```77Display output verbatim. Then ask: "Continue from here? Or has anything changed?"78If user reports changes → run `/ck:save` immediately.79 80---81 82### `/ck:info [name|number]` — Quick Snapshot83```bash84node "$HOME/.claude/skills/ck/commands/info.mjs" [arg]85```86Display output verbatim. No follow-up question.87 88---89 90### `/ck:list` — Portfolio View91```bash92node "$HOME/.claude/skills/ck/commands/list.mjs"93```94Display output verbatim. If user replies with a number or name → run `/ck:resume`.95 96---97 98### `/ck:forget [name|number]` — Remove a Project99First resolve the project name (run `/ck:list` if needed).100Ask: `"This will permanently delete context for '<name>'. Are you sure? (yes/no)"`101If yes:102```bash103node "$HOME/.claude/skills/ck/commands/forget.mjs" [name]104```105Display confirmation verbatim.106 107---108 109### `/ck:migrate` — Convert v1 Data to v2110```bash111node "$HOME/.claude/skills/ck/commands/migrate.mjs"112```113For a dry run first:114```bash115node "$HOME/.claude/skills/ck/commands/migrate.mjs" --dry-run116```117Display output verbatim. Migrates all v1 CONTEXT.md + meta.json files to v2 context.json.118Originals are backed up as `meta.json.v1-backup` — nothing is deleted.119 120---121 122## SessionStart Hook123 124The hook at `~/.claude/skills/ck/hooks/session-start.mjs` must be registered in125`~/.claude/settings.json` to auto-load project context on session start:126 127```json128{129  "hooks": {130    "SessionStart": [131      { "hooks": [{ "type": "command", "command": "node \"~/.claude/skills/ck/hooks/session-start.mjs\"" }] }132    ]133  }134}135```136 137The hook injects ~100 tokens per session (compact 5-line summary). It also detects138unsaved sessions, git activity since last save, and goal mismatches vs CLAUDE.md.139 140---141 142## Rules143- Always expand `~` as `$HOME` in Bash calls.144- Commands are case-insensitive: `/CK:SAVE`, `/ck:save`, `/Ck:Save` all work.145- If a script exits with code 1, display its stdout as an error message.146- Never edit `context.json` or `CONTEXT.md` directly — always use the scripts.147- If `projects.json` is malformed, tell the user and offer to reset it to `{}`.