@judepayne/picode

A Pi package for disciplined, role-based coding workflows with mode switching, permissions, subagents, and prompt vars.

Package details

← Back
extensionskill

Install @judepayne/picode from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@judepayne/picode
Package
@judepayne/picode
Version
1.0.0
Published
May 2, 2026
Downloads
not available
Author
judepayne
License
MIT
Types
extension, skill
Size
588.2 KB
Dependencies
0 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ],
  "image": "https://raw.githubusercontent.com/judepayne/picode/main/img/picode-preview.png"
}

Security note

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

README

picode

A homage to OpenCode in Pi.

GitHub: https://github.com/judepayne/picode

A Pi package for disciplined, role-based coding workflows with mode switching, permissions, subagents, and prompt vars.

picode preview

Install

pi install npm:@judepayne/picode

Then reload Pi:

/reload

Optionally bootstrap prompt-vars files in your project:

/vars bootstrap

What it adds

  • Builder, Planner, and Designer runtime modes with their own prompts, tools, permission profiles, and style.
  • Scout, worker, and reviewer subagents for delegated reconnaissance, implementation, and review.
  • An OpenCode inspired permission system for each agent/subagent.
  • Prompt vars such as ${plan.path} and ${design.path} for project-aware agent instructions.
  • Custom markdown cards so you can override or add your own agents and subagents.

Basic use

Switch agents with Ctrl + , and Ctrl + ., or use the /agents command in Pi.

Generally the Builder, Planner, and Designer agents dispatch subagents as they need to, but you can also dispatch subagents directly when useful. Subagents can run synchronously or asynchronously:

~scout inspect this area and report back
~reviewer review the current diff

Customisation

Point picode at your own agent/subagent card directories in .pi/settings.json:

{
  "picode": {
    "agentsDir": "./custom-agents",
    "subagentsDir": "./custom-subagents"
  }
}

Same-filename overlay cards partially override built-in cards, so you can change one setting without copying the whole prompt.

Links