Codella Pi Packages

A monorepo of Pi packages published under the @codella npm scope.

Packages

Package	Type	Description
@codella/pi-theme-cyberpunk	Theme	Neon cyberpunk TUI theme for Pi.
@codella/pi-theme-candy	Theme	Bright neon candy TUI theme for Pi.
@codella/pi-theme-christmas	Theme	🎄 Festive Christmas TUI theme for Pi.
@codella/pi-theme-halloween	Theme	🎃 Spooky Halloween TUI theme for Pi.
@codella/pi-theme-grayscale	Theme	Minimal monochrome grayscale TUI theme for Pi.
@codella/pi-prompt-plan	Prompt template	/plan prompt command for explicit plan-first workflows.
@codella/pi-plan-mode	Compatibility prompt template	Old package name for @codella/pi-prompt-plan.
@codella/pi-mcp-support	Extension	Generic Model Context Protocol (MCP) support for Pi.

Install

Install packages individually:

pi install npm:@codella/pi-theme-cyberpunk
pi install npm:@codella/pi-theme-candy
pi install npm:@codella/pi-theme-christmas
pi install npm:@codella/pi-theme-halloween
pi install npm:@codella/pi-theme-grayscale
pi install npm:@codella/pi-prompt-plan
pi install npm:@codella/pi-mcp-support

After installing a theme, select it from /settings or set one of the theme names in Pi settings:

{
  "theme": "cyberpunk"
}

{
  "theme": "candy"
}

{
  "theme": "christmas"
}

{
  "theme": "halloween"
}

{
  "theme": "grayscale"
}

MCP configuration

@codella/pi-mcp-support reads MCP servers from:

1. Project config: .pi/mcp.json
2. Global Pi config: ~/.pi/agent/mcp.json
3. Legacy global config: ~/.pi/mcp.json

Example:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "remote": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ${MCP_TOKEN}"
      }
    }
  }
}

Development

Validate package metadata and theme tokens:

npm run validate

Dry-run package tarballs:

npm run pack:dry-run

Or one package at a time:

npm run pack:theme
npm run pack:candy
npm run pack:christmas
npm run pack:halloween
npm run pack:grayscale
npm run pack:plan
npm run pack:plan-mode
npm run pack:mcp

Publishing

Publish one package at a time from this workspace after reviewing npm pack --dry-run output:

npm publish -w @codella/pi-theme-cyberpunk --access public
npm publish -w @codella/pi-theme-candy --access public
npm publish -w @codella/pi-theme-christmas --access public
npm publish -w @codella/pi-theme-halloween --access public
npm publish -w @codella/pi-theme-grayscale --access public
npm publish -w @codella/pi-prompt-plan --access public
npm publish -w @codella/pi-plan-mode --access public
npm publish -w @codella/pi-mcp-support --access public

Do not publish without explicit confirmation.

License

MIT