jared
/
cc-os
1
0
Fork 0
Code Issues 18 Pull Requests Packages Projects Releases Wiki Activity
cc-os/plugins/os-vault
History
jared a2b329dd7f Audit os-* plugins against cc-architect standards + remediate 
Post-Phase-B standards audit (backlog ticket): ran cc-architect's
audit-plugin checklist against all 8 os-* plugins and remediated:

- index-style CLAUDE.md (ADR-0032) for every plugin; os-doc-hygiene's
  stale cc-plugins-era CLAUDE.md/PRD.md reconciled
- invariants.md added for os-shortcuts and os-vault
- naming convention folded into cc-architect references (canonical:
  references/conventions/cc-os-naming.md); CLAUDE.md + vault note point there
- repo-level bin/test runner for the mixed minitest/pytest suites (6 pass)
- os-vault settings.json hook wiring documented as deliberate
- ADR-0025/os-adr: exemption already recorded in the ADR; no retrofit
- deferred to retire-planka rework: os-backlog ADR-0025 deviations
  (Forgejo jared/cc-os#74), Planka refs in os-context/os-status

Detail: docs/implementation-status/standards-audit.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NCs64GAhRWrnjwfGwS4biX
 		2026-07-16 15:34:41 -04:00
..
.claude-plugin Rename memory plugin to os-vault; fix marketplace registration 2026-07-03 09:43:18 -04:00
eval os-vault: WS2 wording loop — destination ladder shipped, reserve grid measured 2026-07-07 14:01:15 -04:00
hooks os-vault: add SessionStart git pull for multi-machine vault/memsearch freshness 2026-07-10 10:06:55 -04:00
skills os-vault: WS2 wording loop — destination ladder shipped, reserve grid measured 2026-07-07 14:01:15 -04:00
tests Rename memory plugin to os-vault; fix marketplace registration 2026-07-03 09:43:18 -04:00
.gitignore Rename memory plugin to os-vault; fix marketplace registration 2026-07-03 09:43:18 -04:00
CLAUDE.md Audit os-* plugins against cc-architect standards + remediate 2026-07-16 15:34:41 -04:00
README.md Audit os-* plugins against cc-architect standards + remediate 2026-07-16 15:34:41 -04:00
config.yaml Rename memory plugin to os-vault; fix marketplace registration 2026-07-03 09:43:18 -04:00
invariants.md Audit os-* plugins against cc-architect standards + remediate 2026-07-16 15:34:41 -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/query/SKILL.md — When and how to query the vault graph
  • skills/write/SKILL.md — When and how to write to the vault
  • skills/reorganize/SKILL.md — Plan-mode vault consolidation
  • skills/onboard-project/SKILL.md — Onboard, update, remove, or query the per-project Graphify knowledge graph (codebase structure, this repo only)
  • skills/design-template/SKILL.md — Design or revise SecondBrain note-type templates, including new-type creation

Configuration

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