npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@vforvaick/pi-codebase-memory-mcp

v0.1.0-beta.1

Published

Unofficial pi coding agent extension wrapping the codebase-memory-mcp binary. Registers 9 cbm_* tools (search_graph, trace_path, architecture, cypher, snippet, changes, coverage, index, projects) with a pi-side freshness gate that auto-reindexes on source

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

vforvaickvforvaick

Keywords

pi-packagepi-extensioncodebase-memorycodebase-memory-mcpmcpcode-graphtree-sittercall-graphdead-codeimpact-analysis

Readme

@vforvaick/pi-codebase-memory-mcp

Unofficial pi coding agent extension wrapping the codebase-memory-mcp binary.

Not affiliated with DeusData/codebase-memory-mcp. MIT.

What it does

  • Registers 9 cbm_* tools the LLM can call: cbm_index, cbm_projects, cbm_search, cbm_trace, cbm_architecture, cbm_snippet, cbm_query (Cypher), cbm_changes (impact analysis), cbm_coverage.
  • Freshness gate: auto-reindexes the graph (mode=moderate) before any read query when source has changed. The CBM binary's native watcher is inert in CLI / MCP-stdio mode (its daemon worker log stays 0 bytes, never fires), so without this gate the graph goes stale after every edit until a manual cbm_index.
  • project is auto-inferred from the session cwd, so callers rarely pass it.

Prerequisites

  1. pi coding agent installed.
  2. codebase-memory-mcp binary on PATH. Install from upstream:
    curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
    Verify: codebase-memory-mcp --version.

Install

pi install npm:@vforvaick/pi-codebase-memory-mcp

After install, restart pi.

Usage

In any repo:

cbm_index               # one-time index (mode=moderate)
cbm_search .*Router.*   # find symbols
cbm_trace myFunction --direction both
cbm_architecture

Once indexed, the graph auto-refreshes after edits (see Freshness gate below). Tools auto-appear in the function list.

Freshness gate

The extension keeps a per-cwd dirty flag, bumped by pi lifecycle hooks:

  • session_start -> mark cwd dirty (forces one reindex on first query, catches cross-session drift)
  • tool_execution_end for edit / write / bash / ctx_execute / apply_patch (on success) -> mark dirty
  • user_bash -> mark dirty conservatively

Before each read query (cbm_search, cbm_trace, etc.) the extension calls ensureFresh(cwd): if the cwd is dirty or git HEAD has drifted since the last index, it reindexes (mode=moderate) then serves the query. Race-safe via a per-cwd in-flight lock + dirty generation counter.

What the gate does NOT catch: mutations from external editors or other terminals (VSCode, sed in another shell) after the first query in a session. For those, run cbm_index manually.

Configuration

  • CBM_BIN environment variable overrides the binary path. Default: codebase-memory-mcp (looked up on PATH).

Compatibility

  • Tested against codebase-memory-mcp v0.9.0.
  • Support policy: current + previous minor of codebase-memory-mcp.
  • Known v0.9.0 quirk: check_index_coverage returns "unknown tool" via MCP. This extension routes it through cli mode, where it works. Tool list parity (advertised vs callable) is tracked upstream.

Security

  • Runs the codebase-memory-mcp binary with the same filesystem access as your pi session.
  • No telemetry. No network calls. Source is open - review before install.
  • pi packages run with full system access; review the source at the repo before installing.

License

MIT. (C) vforvaick.

Contributing

PRs welcome at github.com/vforvaick/pi-codebase-memory-mcp.