Freebuild for Pi

Pi extension that connects Pi to the Freebuild broker and shows the sponsor panel during sponsored runs.

This is the Pi beta.

Install

pi install npm:@freebuild/pi@latest

For local development from this repository:

pi install "$(pwd)/pi-extension"

Restart Pi, then:

/freebuild-license

Choose Buy a new license to open checkout in your browser, or I already have a key to paste one you bought in the browser. Checkout includes email verification. Keep the terminal open while the browser finishes.

You can also pass a key directly:

/freebuild-license fb_...

The command verifies the key against the broker, saves it to ~/.config/freebuild/credentials.json, registers the provider, and selects DeepSeek V4.1 Flash 1017.

Use

/model

Choose:

freebuild/deepseek-flash

The extension registers the provider as freebuild and sends:

• Authorization: Bearer <license key>
• X-Freebuild-Install: <install id>
• X-Freebuild-Client: pi/0.0.4
• X-Freebuild-Client: pi/0.0.4-headless in print and JSON modes

Activation also writes defaultProvider: "freebuild" and defaultModel: "deepseek-flash" to your Pi settings so new sessions start on the sponsored model. If you already set a different provider as your default, the extension leaves it alone unless you explicitly run /freebuild-setup.

Sponsor panel

The panel appears above the editor while a sponsored run is active. On terminals at least 80 columns wide it uses a large full-width layout with a big image, a large wordmark, and a copy block. Narrow terminals fall back to the compact panel.

• SPONSORED for paid campaigns
• AFFILIATE for affiliate campaigns
• FREEBUILD for house inventory
• ADVERTISE for house advertising inventory

Print and JSON modes do not render the panel and do not record impressions. That avoids counting an ad the user could not see.

Click the panel body to open the sponsor, or use alt+o:

/freebuild-sponsor

Clicking uses the campaign currently drawn in the panel, so the brand and the destination always match. The loading and error panels are not clickable. In Pi's regular TUI mode the terminal owns the mouse; use alt+o there.

The plugin records open and close events for each run and uses the tracked click endpoint when possible. Image-only campaigns always render their campaign label, the brand, and the open hint, so Pi never shows a terminal panel with only an image.

Commands

/freebuild-license [key]  Connect, reconnect, or buy a license
/freebuild-key            Paste a license key
/freebuild-founding       Redeem a founding beta code
/freebuild-setup          Configure the provider and default model
/freebuild-plan           Show plan and usage
/freebuild-billing        Open the billing portal
/freebuild-sponsor        Open the current sponsor
/freebuild-adtest         Preview the sponsor panel for 8 seconds
/freebuild-update         Check for a new version and open the Pi guide
/freebuild-status         Show license, plan, model, install, and broker

Environment

FREEBUILD_CREDENTIALS   Override the credentials file path
FREEBUILD_API_URL       Override the web origin
FREEBUILD_BROKER_URL    Override the broker URL
FREEBUILD_SPONSOR_URL   Override the sponsor panel URL
FREEBUILD_LICENSE_KEY   Override the stored license key
PI_CODING_AGENT_DIR     Override the Pi agent directory (settings and test profile)

Development

Load the extension without installing it:

pi --no-extensions -e ./pi-extension --list-models freebuild

Test in an isolated profile:

PI_CODING_AGENT_DIR="$TEMP/freebuild-pi-test" pi --no-extensions -e ./pi-extension --model freebuild/deepseek-flash

The package has no build step. Pi loads TypeScript through jiti.

License

Proprietary. Copyright (c) 2026 Freebuild. All rights reserved.

This package is licensed under the Freebuild Proprietary License. See LICENSE.