Disclaimer: This plugin has been generated using AI

Pi Neuralwatt Extension

This extension adds Neuralwatt support to the PI coding agent.

Installation

Install with one of the following:

pi install npm:pi-neuralwatt
pi install git:github.com/tedewaard/pi-neuralwatt
pi install https://github.com/tedewaard/pi-neuralwatt

Configuration

API Key Setup

You can set your Neuralwatt API key in one of two ways:

Option 1: Environment Variable (Recommended)

Set the following variable in your shell or shell configuration before launching PI:

export NEURALWATT_API_KEY=<your_neuralwatt_api_key>

Option 2: Interactive Setup

If you don't set the environment variable, PI will guide you through configuring the API key interactively when you need to use Neuralwatt features.

No API Key?

If no API key is configured, the extension will log a non-critical warning and fall back to a preset list of models, but interactive features like /energy and /quota will show an error when accessed without a key.

Feature Highlights

• Model Registration – On startup/reload, the extension queries https://api.neuralwatt.com/v1/models unauthenticated and registers all returned models as a provider named neuralwatt. A preset fallback model list is always available at load time. If the live fetch fails, it gracefully continues with the fallbacks.
• Status‑bar widget – Displays current quota usage, remaining balance, monthly usage and cost. Updated on session start and after each LLM turn.
• Slash Commands
  • /energy – Shows a detailed energy‑consumption report for the current period, including requests, energy in kWh/µWh, and estimated cost.
  • /quota – Shows your account balance, running totals for the current month and lifetime, rate‑limit tier, and snapshot timestamp.
• Reasoning‑aware models – The extension marks certain models as reasoning capable. In configuration you can specify which models; these fields are used internally when crafting requests.
• Token & cost overrides – For small‑context models you can override the maxTokens value for better interaction (see MAX_TOKENS_OVERRIDE).

Usage Example

# start PI normally – the extension is auto‑loaded
pi

Once PI starts, you can run:

/energy
/quota

Live status information will appear in the status bar (bottom of the terminal).