Swarm Pi Code Plugin

swarm-pi-code-plugin

[繁體中文](README.zh-TW.md)

Swarm Pi is a portable [Agent Plugins 1.0](https://agent-plugins.org/specification) package with native Claude Code and Codex adapters. Its ten Agent Skills connect a compatible client to a bounded Pi worker for grounded repository questions, plans, reviews, discovery, setup, scaffolding, and authorized implementation. The Host retains intent, approval, verification, and delivery. Pi never owns commit, merge, push, deployment, messaging, or transactions.

Quick start

Install from the shared marketplace, then open Configuration from Claude Code or Codex. Connect a provider, select a primary model and fallback, configure roles and project scope, then save.

claude plugin marketplace add https://github.com/JiaWeiXie/swarm-pi-code-plugin
claude plugin install swarm-pi-code-plugin@swarm-pi-code-plugin

For Codex:

codex plugin marketplace add https://github.com/JiaWeiXie/swarm-pi-code-plugin
codex plugin add swarm-pi-code-plugin@swarm-pi-code-plugin-local

For any other [Agent Plugins-compatible client](https://agent-plugins.org/compatible-clients), point its local-package flow at the package root `plugins/swarm-pi-code-plugin/`. The client reads `plugin.json` and discovers each skill at `skills//SKILL.md`; a generic client exposes the ten skills by their frontmatter `name`. Install, enable, permissions, the outer sandbox, and the user interface stay under client control.

For local development:

mise run build
mise exec -- node scripts/pi-runner.mjs status --json
mise exec -- node scripts/pi-runner.mjs configure --host codex

Packaged runtime requirements: Node.js 22.19+, local shell command execution, first-run npm registry access, and a writable plugin directory for the exact pinned dependencies installed on first run. Mutation workflows additionally require Git for worktree-aware changes; a read-only package directory is not supported and fails with the existing bootstrap e