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	Dark pastel candy TUI theme for Pi.
@codella/pi-plan-mode	Extension	Approval-gated read-only plan mode for Pi.
@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-plan-mode
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"
}

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:plan
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-plan-mode --access public
npm publish -w @codella/pi-mcp-support --access public

Do not publish without explicit confirmation.

License

MIT