@rolemodel/chains — Dynamic Chain Extension

This extension discovers .chain.json files and registers a slash command for each one, so you can invoke a multi-step subagent pipeline as /<chain-name> <task> instead of /run-chain <chain-name> -- <task>. It is not a subagent tool — it has no chaining or subagent logic of its own. The actual subagent execution comes from the pi-subagents extension's chain mode. This extension is purely an alias layer: it reads chain files, translates them into a subagent({ chain: [...] }) call, and injects that into your session.

Requires pi-subagents installed and enabled. If the subagent tool is not available, chain commands will fail with "Invalid parameters" errors.

Table of Contents

• Quick Start
• Chain File Format
• Configuration

Quick Start

# 1. Install the subagent extension (required dependency)
pi install npm:pi-subagents

# 2. Install this chains extension
pi install npm:@rolemodel/pi-chains

# 3. Create a chain directory and write your first chain
mkdir -p ~/.pi/agent/chains

cat > ~/.pi/agent/chains/my-review.chain.json << 'EOF'
{
  "name": "my-review",
  "description": "Review PR and suggest improvements",
  "chain": [
    { "agent": "reviewer", "task": "Review changes: {task}" },
    { "agent": "worker", "task": "Suggest improvements: {previous}" }
  ]
}
EOF

Reload and use:

/reload
/my-review Add input validation to the auth endpoint

Chain File Format

This follows the format from pi-subagents. It requires the JSON format. Any chains with the markdown syntax will not be registered.

Configuration

Chain Directories

The extension searches chain directories in this order:

| Priority | Location | Scope | |----------|----------|-------| | 1 | ~/.pi/agent/chains/ | Global (all projects) | | 2 | .pi/agent/chains/ (relative to cwd) | Project-local (only if it exists) |

Chains are discovered at extension startup and on /reload.