claude

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).

1 on GitHubby vilosourcev0.24.0MITupdated 7 days ago
/

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)

  • brief

    Session-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

  • handoff

    End-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

  • update

    Check 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

  • vfkb

    Work 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)

  • briefer

    Session-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.

  • updater

    vfkb 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)

  • vfkb

    runs: 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

View source on GitHub

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.

claude & codex pluginslisted