A collection of extensions, reusable agent skills, prompts, themes, and session analysis tools for Pi, focused on planning, collaboration, project-aware automation, and safe development workflows.
pi install git:github.com/halqme/pi-kit
Requirements:
- Node.js 24 or later
- Bun 1.3.14 or later
Recommendation:
- npm:@ollama/pi-web-search
Settings:
{
"enabledModels": [
"openai-codex/gpt-5.6-luna:max",
"openai-codex/gpt-5.6-terra:max",
"openai-codex/gpt-5.6-sol:high"
]
}Pi discovers extensions from the extensions/ directory. Each extension is an independent Bun workspace package with its own documentation and checks.
See each extension's README for its behavior, tools, hooks, and constraints. Workspace-level commands are covered in the extension development guide.
Additional standalone packages live under packages/. See each package's documentation for usage and constraints.
- Reusable workflows live under
skills/; each skill is defined by aSKILL.mdfile. - Prompt templates live under
prompts/. - Themes live under
themes/.
agent-team runs its discussion members as isolated Pi subprocesses through the bundled background-process extension.
Install dependencies from the repository root:
bun installRun all extension checks from the extension workspace:
cd extensions
bun run checkThe full check runs strict TypeScript checks and Node test-runner tests for every extension. You can also run one kind of check across the workspace:
bun run typecheck
bun run testTo work on a single extension, use its package name:
bun --filter @halqme/agent-team dev
bun --filter @halqme/agent-team smokeReplace @halqme/agent-team with the target package name. After changing an extension already loaded by Pi, run /reload in the Pi session.
.
├── extensions/ # Pi extensions and Bun workspace configuration
├── packages/ # Standalone packages such as session-metrics
├── skills/ # Reusable agent workflows
├── prompts/ # Prompt templates
├── themes/ # Pi themes
├── package.json # Pi package metadata
└── bun.lock # Locked dependencies