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:[email protected]: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 [email protected] - VelocityKode