@sean_pedersen/pi-codegraph

Pi coding agent extension that wires codegraph (tree-sitter knowledge graph) as an MCP sidecar and injects usage instructions into the system prompt

Packages

Package details

extension

Install @sean_pedersen/pi-codegraph from npm and Pi will load the resources declared by the package manifest.

npm repo report
$ pi install npm:@sean_pedersen/pi-codegraph
Package
@sean_pedersen/pi-codegraph
Version
0.1.0
Published
May 25, 2026
Downloads
179/mo · 36/wk
Author
sean_pedersen
License
MIT
Types
extension
Size
9.3 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-codegraph

A pi coding agent extension that wires codegraph as an MCP sidecar and injects structured usage instructions into the system prompt.

What it does

When a project has a .codegraph/ index, this extension:

  1. Spawns codegraph serve --mcp as a sidecar process
  2. Registers all codegraph tools (codegraph_search, codegraph_callers, codegraph_callees, codegraph_impact, codegraph_node, codegraph_context, codegraph_explore, codegraph_files, codegraph_status) directly in the session
  3. Injects a ## CodeGraph section into the base system prompt via APPEND_SYSTEM.md so the instructions are present from session startup — not just on the first agent turn

If the project has no .codegraph/ directory the extension is a no-op.

Requirements

  • codegraph CLI must be on $PATH
  • A .codegraph/ index must exist in the project root (run codegraph init -i to build one)

Install

As a pi package

/add @sean_pedersen/pi-codegraph

Manual (git)

/add https://github.com/SeanPedersen/pi-codegraph

Building the index

codegraph init -i        # initial index build

The file watcher keeps the index current while pi is running.