marionettist-pathway-pi

Project-local Pi pathway package for Marionettist.

Packages

Package details

extension

Install marionettist-pathway-pi from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:marionettist-pathway-pi

Package: marionettist-pathway-pi
Version: 0.3.5
Published: Aug 10, 2026
Downloads: 86/mo · 44/wk
Author: pandaria75
License: unknown
Types: extension
Size: 150.7 KB
Dependencies: 2 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./extension/index.ts"
  ],
  "subagents": {
    "agents": [
      "./resources/agents"
    ]
  }
}

Security note

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

README

Marionettist Pi Pathway

This pathway packages the Marionettist skills, prompt workflows, seven default agents, and the pi-subagents runtime for project-local Pi installations.

Install it from the target project only:

pi install -l npm:marionettist-pathway-pi

The package uses pi-subagents for dynamic agent discovery and orchestration. Its seven built-in Marionettist agents are package defaults; project definitions in .pi/agents/**/*.md can add new agents or override them by name.

/marionettist is a parent-builder command, not a plain prompt template. It activates the complete Marionettist builder contract in the interactive parent session, resolves the builder model from subagents.agentOverrides when one is configured, and delegates only the six specialist roles. Internal analysis and same-slice coding/review/validation delegation does not require user approval; the builder pauses only at real Marionettist gates. The mode persists when a Pi session is resumed. Run /marionettist-exit to leave it explicitly.

Package agents inherit the active Pi model after direct installation. Running marionettist init --with-pi or marionettist sync --with-pi maps the shared .marionettist/model-profiles.yml values into project agentOverrides.

The extension intentionally keeps skills, prompts, and the subagent runtime disabled unless the package is present in the nearest project .pi/settings.json.

If pi-subagents is already configured at the user or project scope, the pathway reuses that runtime rather than registering duplicate subagent tools.