vfkb
Per-project knowledge substrate: session continuity, decision/gotcha/pattern capture, and search — via human-facing skills incl. /vfkb:brief session-start briefing, /vfkb:handoff session-end synthesis, and /vfkb:update self-update (agents get the same via the bundled MCP server).
Plugin vfkb from marketplace vfkb in vilosource/vfkb-claude-plugin. Commands read from the repo's manifest — 6 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.
What it installs
Skills (4)
briefSession-start briefing — what the last session finished, what has moved since, and what's next, from the project's vfkb handoff cross-checked against git and the GitHub queue. Use when the user asks to be briefed, "where did we leave off", "what's next", "catch me up", or at the start of a work sess
handoffEnd-of-session synthesis — reviews everything done this session (decisions, work, gotchas, open threads) and writes one comprehensive handoff entry so the next /vfkb:brief starts with full context instead of a thin floor. Use when the user asks to "write a handoff", "wrap up", "leave notes for next
updateCheck whether a newer version of the vfkb plugin is available for THIS project and update it if so. Use when the user asks to "update vfkb", "check for a vfkb update", "is there a newer vfkb", or wants to make sure they have the latest skills/fixes before relying on them. Runs forked on Haiku (ADR-0
vfkbWork with vfkb (ViloForge KnowledgeBase), this project's per-project knowledge substrate — resume prior session context, record decisions/facts/gotchas/patterns, search past knowledge, or check wiring health. Use when the user asks to "resume", "what did we decide", "remember this", "record a decisi
Subagents (2)
brieferSession-start briefing courier — reads the project's pinned vfkb handoff, checks what has moved since it was written, and reports "last done / what's next" with any discrepancies. Retrieval and restatement over a checklist, not open-ended judgment.
updatervfkb self-update courier — checks this project's installed vfkb plugin version against the latest release and updates it if newer. Mechanical command-and-report over a fixed checklist, not open-ended judgment.
MCP servers (1)
vfkbruns: node ${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb-mcp.mjs
Hooks (7)
- SessionStart
VFKB_DATA_DIR=${CLAUDE_PROJECT_DIR:-.}/.vfkb node "${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb.mjs" hook session-start
- PreToolUse
VFKB_DATA_DIR=${CLAUDE_PROJECT_DIR:-.}/.vfkb node "${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb.mjs" hook pre-tool-use
- PreToolUse
node "${CLAUDE_PLUGIN_ROOT}/hooks/git-compound-guard.mjs"
- PreToolUse
node "${CLAUDE_PLUGIN_ROOT}/hooks/durable-claim-check.mjs"
- UserPromptSubmit
VFKB_DATA_DIR=${CLAUDE_PROJECT_DIR:-.}/.vfkb node "${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb.mjs" hook user-prompt-submit
- Stop
VFKB_DATA_DIR=${CLAUDE_PROJECT_DIR:-.}/.vfkb node "${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb.mjs" hook stop
- SessionEnd
VFKB_DATA_DIR=${CLAUDE_PROJECT_DIR:-.}/.vfkb node "${CLAUDE_PLUGIN_ROOT}/dist/bundles/vfkb.mjs" hook session-end
Maintain vfkb?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.