vp-knowledge
A Claude Code plugin that turns Basic Memory into an actively maintained knowledge graph. Research packages from six ecosystems and tools from five dev-environment categories using parallel enrichment, find documentation gaps in your projects, surface project-relevant knowledge before coding, and let autonomous agents audit and improve your notes — all without leaving your terminal.
Breaking change in v0.22.0
Note titles and wiki-links now use hyphen delimiters (npm-fastify,
[[npm-fastify]]) instead of colons (npm:fastify, [[npm:fastify]]).
User command syntax is unchanged (/package-intel npm:fastify). Existing
vault notes need a one-time migration — see
TODO-obsidian-migration.md.
What it does
/package-intel <pkg> — Research any package
Queries six sources in parallel, synthesizes a structured note, and cross-links existing notes. Supports six ecosystems:
| Form | Ecosystem | Example |
|---|
<name> (no prefix) | npm (default) | fastify |
npm:<name> | npm | npm:@fastify/postgres |
crate:<name> | Rust / crates.io | crate:serde |
go:<module/path> | Go modules | go:github.com/gin-gonic/gin |
composer:<vendor>/<pkg> | PHP / Packagist | composer:laravel/framework |
pypi:<name> | Python / PyPI | pypi:requests |
gem:<name> | Ruby / RubyGems | gem:rails |
/package-intel @fastify/postgres
/package-intel crate:serde
/package-intel pypi:requests
| Source | What it finds |
|---|
| Basic Memory | Existing notes, cross-references, usage patterns |
| DeepWiki | Architecture, design patterns, key APIs (2-3 targeted questions) |
| Context7 | API reference, code examples |
| Tavily | Security advisories, recent CVEs (RUSTSEC, PyPA, RubySec, etc.) |
| Raindrop | Your bookmarked articles (with full content extraction) |
| Readwise | Your highlights and saved articles about the package |
Plus changelog analysis via GitHub releases. After writing, searches for existing notes that reference the package and adds bidirectional cross-links. The result is an ecosystem-prefixed note (npm-*, crate-*, pypi-*, etc.) with observations, relations, and release highlights — connected into the graph from day one.
/tool-intel <prefix>:<name> — Research any dev tool
Queries five sources in parallel, synthesizes a structured note, and cross-links existing notes. Supports five tool categories:
| Form | Category | Example |
|---|
brew:<name> | Homebrew formula | brew:ripgrep |
cask:<name> | Homebrew cask | cask:warp |
action:<owner>/<repo> | GitHub Action | action:actions/checkout |
docker:<image> | Docker Hub image | docker:node |
vscode:<publisher>.<ext> | VSCode extension | vscode:esbenp.prettier-vscode |
/tool-intel brew:ripgrep
/tool-intel action:actions/checkout
/tool-intel docker:node
/tool-intel vscode:esbenp.prettier-vscode
| Source | What it finds |
|---|
| Basic Memory | Existing notes, cross-references |
| DeepWiki | Architecture, design patterns (actions and docker only) |
| Tavily | Security advisories, CVEs, supply-chain risks, gotchas |
| Raindrop | Your bookmarked articles (with full content extraction) |
| Readwise | Your highlights and saved articles about the tool |
Plus version/changelog data (GitHub releases for actions, Docker Hub tags for images, API versions for brew/vscode). After writing, searches for existing notes that reference the tool and adds bidirectional cross-links. The result is a prefixed note (brew-*, action-*, etc.) with type-specific sections — ## Inputs & Outputs + ## Permissions for actions, ## Tags + ## Base Layers for Docker, ## Common Usage for formulae — plus observations and relations.
/knowledge-gaps — Find undocumented dependencies
Scans your project's manifest files for both code dependencies and dev tooling, checks which have Basic Memory notes, and reports the gaps:
## Knowledge Gap Report — my-project
### npm Coverage: 12/47 packages documented (25%)
#### Tier 1 — Must Document (3+ imports)
| Package | Import Count | Domain |
|---------|--------------|----------------------|
| fastify | 12 | engineering/fastify/ |
| pg | 8 | engineering/ |
#### Tier 2 — Should Document (1-2 imports)
...
---
### crates Coverage: 3/18 packages documented (17%)
#### Tier 1 — Must Document (3+ imports)
| Package | Import Count | Domain |
|---------|--------------|----------|
| serde | 28 | crates/ |
...
---
### Overall Summary
- Total packages across all ecosystems: 65
- Documented: 15 (23%)
- Undocumented Tier 1: 8 packages
voxpelli