knowledge-codex

Codex CLI plugin for the knowledge vault — journal, search, enrichment, and compaction recovery.

Usage

Install via Codex CLI:

codex plugin install agiterra/knowledge-codex

Skills

• /knowledge:boot — Restore vault state after compaction
• /knowledge:init — Set up a new .knowledge/ vault
• /knowledge:scan — Scan vault file headers (build mental index)
• /knowledge:index — Build/maintain semantic keyword index
• /knowledge:search — Search vault by keywords
• /knowledge:associate — Fast keyword-only associations
• /knowledge:enrich — Deep hybrid search (keyword + vector + LLM filter)
• /knowledge:journal — Append-only log of WHY beliefs exist
• /knowledge:calibrate — Measure compaction fidelity
• /knowledge:vectorize — Build vector embeddings
• /knowledge:save — Deliberate session preservation before exit
• /knowledge:fork — Spawn a warm research fork with session context
• /knowledge:handoff — Self-compaction: save, spawn fresh, verify, swap

Hooks

• UserPromptSubmit — Injects relevant vault context on each prompt
• PreCompact — Backs up transcript and recovery data
• SessionStart — Reminds agent to boot after compaction
• SessionEnd — Auto-commits vault changes as safety net

Source

• Tools: @agiterra/knowledge-tools
• Claude Code adapter: @agiterra/knowledge-claude-code