@velocitykode/velocity-peregrine

Peregrine - Velocity-native AI software engineer, as a Pi package. Persona, rules, skills, and the velocity-kb + velocity-arrow MCP bridge.

Packages

Package details

extensionskillthemeprompt

Install @velocitykode/velocity-peregrine from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@velocitykode/velocity-peregrine

Package: @velocitykode/velocity-peregrine
Version: 0.0.2
Published: Aug 16, 2026
Downloads: 375/mo · 15/wk
Author: velocitykode-ali
License: MIT
Types: extension, skill, theme, prompt
Size: 18.2 MB
Dependencies: 1 dependency · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./extensions",
    "node_modules/pi-mcp-extension/src/index.ts"
  ],
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

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

README

Peregrine

The Velocity AI Agent. A Pi package (@velocitykode/velocity-peregrine) that turns Pi into a Velocity-native software engineer: persona, extensions, skills, and the velocity-arrow MCP bridge.

Pi is the engine; Velocity is the brain (velocity-arrow MCP + kb tools).

Install

npm i -g @earendil-works/pi-coding-agent   # pi, if not present
pi install npm:@velocitykode/velocity-peregrine

Or straight from git:

pi install git:git@github.com:velocitykode/velocity-peregrine

That gives every pi session the full persona, skills, and MCP wiring.

MCP server config lives outside the package: ~/.pi/agent/mcp.json (global) or <project>/.pi/mcp.json. Point velocity-arrow at your arrow binary:

{
  "mcpServers": {
    "velocity-arrow": { "command": "arrow", "args": ["mcp"] }
  }
}

Development

npm install        # bundles pi-mcp-extension
npm link           # exposes the `peregrine` launcher
peregrine -p "who are you"   # headless smoke: persona + skills + MCP tools load

peregrine is pi -e <repo root> with all flags passed through. Do not keep the package pi installed globally on a dev machine: it double-loads extensions against the launcher and conflicts.

Layout

Path	Purpose
`bin/`	`peregrine` launcher
`contract/`	Face contract: fold the `--mode json` event stream into `peregrine.result/v1` (import `@velocitykode/velocity-peregrine/contract`)
`examples/`	Reference headless caller for the face contract (not shipped to npm)
`extensions/`	Pi extensions (persona injection, model routing, go_check)
`persona/`	`PERSONA.md` system prompt
`skills/`	Agent skills (idiom-guard, scaffold-via-generator, velocity-integration-test)
`prompts/`, `themes/`	Pi prompt templates and themes
`reference/go/`	Frozen legacy Go engine, never compiled

Author

Ali Raza ali@velocitykode.com - VelocityKode