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