How eazy-k/vault-engine works
vault-engine is a local, model-independent notes engine: an agent or user invokes its CLI to retrieve task-relevant context from a separate data repository, while optional setup, project discovery, agent integrations, and maintenance support that workflow. The README documents the major capabilities; sampled source confirms the retrieval engine’s weighted-note model and selected module relationships. Some command dispatch and integration wiring is not shown, so those links are omitted or marked unverified.
Main entry points: graph.py Engine CLI · onboarding.py Setup and onboarding · claude_hooks.py Claude hook setup · codex_hooks.py Codex hook setup
Components 19
Context engine
- Engine CLI
tools/graph.py - Weighted retrieval
tools/graph.py - Notes and graph data
- Default notes
defaults
Vault lifecycle
- Vault templates
templates - Setup and onboarding
tools/onboarding.py - Schema migrations
tools/schema.py - Engine updates
tools/update.py
Agent integrations
- Claude hook setup
tools/claude_hooks.py - Claude config dirs
tools/claude_dirs.py - Claude hook handlers
tools/claude-hooks - Codex hook setup
tools/codex_hooks.py - Codex hook handlers
tools/codex-hooks - Model configuration
tools/models.py - Model policy
tools/model_config.py
Supporting features
- Project discovery
tools/discovery.py - Opt-in feedback
tools/feedback.py - Token statistics
tools/token_stats.py
Other components
- User or agent
Connections 20
- User or agent → Engine CLI: invokes commands
README.md - Engine CLI → Weighted retrieval: retrieves context
README.md - Weighted retrieval → Notes and graph data: loads and updates
tools/graph.py - Weighted retrieval → Default notes: loads fallback notes
README.md - Engine CLI → Setup and onboarding: offers setup commands
README.md - Setup and onboarding → Vault templates: scaffolds vault
README.md - Setup and onboarding → Notes and graph data: configures and checks
README.md - Engine CLI → Project discovery: scans projects
README.md - Project discovery → Notes and graph data: caches results
README.md - Engine CLI → Schema migrations: offers migration
README.md - Engine CLI → Engine updates: offers update command
README.md - Engine CLI → Opt-in feedback: offers feedback commands
README.md - Engine CLI → Token statistics: reports usage
README.md - Engine CLI → Claude hook setup: configures Claude hooks
tools/claude_hooks.py - Claude hook setup → Claude config dirs: uses config directories
tools/claude_hooks.py - Claude hook setup → Claude hook handlers: installs handlers
- Engine CLI → Codex hook setup: configures Codex hooks
tools/codex_hooks.py - Codex hook setup → Codex hook handlers: installs handlers
- Engine CLI → Model configuration: offers model settings
tools/models.py - Model configuration → Model policy: loads model policy
tools/models.py