jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/plugins/memory
History
jared 72397a00b8 Add assessment-first onboarding to memory-project skill (ADR-017) 
Onboarding ran a bare `graphify extract`, but graphify does not honor
.gitignore — it needs its own .graphifyignore. Without one, onboarding
viking-warrior-training-log walked node_modules/ (5,858 files) and
routed its non-code files through the Ollama doc pass; the run was
killed after ~1 hour with no graph.json.

Onboarding is now assessment-first: survey the repo, generate a
per-project .graphifyignore (the ignore set varies by stack), confirm
with the user, then extract. Records the gotcha and decision in ADR-017.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 		2026-06-17 09:17:33 -04:00
..
.claude-plugin Source memory plugin in git; port hooks to Python; archive change 2026-06-12 12:42:05 -04:00
hooks Add vault_sync.py hook; complete Step 5b and 2e pilot 2026-06-15 15:23:32 -04:00
skills Add assessment-first onboarding to memory-project skill (ADR-017) 2026-06-17 09:17:33 -04:00
tests Remove dead bash hooks after Python port 2026-06-12 12:52:59 -04:00
.gitignore Source memory plugin in git; port hooks to Python; archive change 2026-06-12 12:42:05 -04:00
README.md Source memory plugin in git; port hooks to Python; archive change 2026-06-12 12:42:05 -04:00
config.yaml Source memory plugin in git; port hooks to Python; archive change 2026-06-12 12:42:05 -04:00

README.md

Memory Plugin for Claude Code

Global Claude Code plugin that integrates the SecondBrain vault and Graphify knowledge graph into Claude sessions.

Requirements

  • Graphify v0.8.31 (pinned — do not upgrade without verifying the patch)
  • Ollama with the qwen25-coder-7b-16k Modelfile-baked model
  • jq available on PATH

Critical: reasoning_effort patch

Graphify v0.8.31 requires a reasoning_effort:"none" patch to prevent hanging on Ollama extraction. After any pip upgrade graphifyy, verify the patch is still present:

python -c "import graphify; import inspect; src = inspect.getsource(graphify); print('patch present' if 'reasoning_effort' in src else 'PATCH MISSING — reinstall v0.8.31')"

If the patch is missing, reinstall the pinned version:

pip install graphifyy==0.8.31

Modelfile-baked context

The num_ctx setting (8192) is baked into the qwen25-coder-7b-16k Ollama Modelfile rather than passed as an env var, because GRAPHIFY_OLLAMA_NUM_CTX propagation is unreliable. If you create a new Modelfile variant, bake num_ctx in directly.

Hooks

  • hooks/session_start.py — SessionStart: staleness check, detached rebuild, vault context injection
  • hooks/session_context.py — UserPromptSubmit: project graph path injection
  • hooks/post_tool_use_write.py — PostToolUse: graph update on vault writes
  • hooks/session_end.py — SessionEnd: episodic journal append
  • hooks/memsearch_sync.py — SessionEnd: memsearch auto-commit+push (ADR-015 behavior, split from session_end by ADR-016)

Shared modules: hooks/config.py, hooks/hook_io.py, hooks/session_state.py.

Skills

  • skills/memory-query.md — When and how to query the vault graph
  • skills/memory-write.md — When and how to write to the vault
  • skills/memory-reorganize.md — Plan-mode vault consolidation

Configuration

Edit cc-os/plugins/memory/config.yaml (or via the symlink ~/.claude/plugins/memory/config.yaml) to change vault path, model, or thresholds.