@mortenmo/vegvisir-pi

Vegvísir extension for pi.dev coding agent

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@mortenmo/vegvisir-pi

Package: @mortenmo/vegvisir-pi
Version: 0.7.1
Published: Oct 27, 2026
Downloads: 889/mo · 220/wk
Author: mortenmo
License: UNLICENSED
Types: extension
Size: 53.7 KB
Dependencies: 2 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./vegvisir.js"
  ]
}

Security note

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

README

@mortenmo/vegvisir-pi

Vegvísir find/read/write extension for the pi coding agent.

Installation

Project-local or CLI

# Test extension directly
pi -e ./packages/pi

# Install package
pi install ./packages/pi

From npm (when published)

pi install npm:@mortenmo/vegvisir-pi

Development

pnpm -r run build   # rebuild packages/core and packages/pi into dist/
pnpm test           # run the full test suite

After changing extension/tool code, restart the session with /new. /reload re-imports the extension module but does not re-bind the tool executors the running conversation is already using, so the old behavior persists until you restart. /reload is fine for skills, prompts, and themes.

Registered Tools

Tool	Parameters	Description
`search`	`pattern`, `and?`, `not?`, `within?`, `path?`, `after?` (4), `before?` (1), `mode?`	Search codebase with boolean filters, returning `<site handle="...">` blocks.
`definition`	`symbolOrSiteId`, `path?`	Extract complete definition body for a class, function, interface, or site handle.
`ls`	`path?`, `recursive?`	Metadata-bearing directory listing.
`read`	`path`, `offset?`, `limit?`	Read file lines (capped at 2k lines / 50 KB). Returns `<file handle="...">`.
`edit`	`handle?`, `path?`, `edits?`, `handles?`, `newText?`	Apply scoped exact replacements or multi-site handle sweeps. Returns next fresh handle.
`write`	`handle?`, `path?`, `content`	Create new files or overwrite existing files (verified via handle). Returns next fresh handle.

System Prompt

The extension injects its toolbelt guidelines into Pi's system prompt automatically via before_agent_start (see src/prompt.ts). No manual configuration is needed.