@freebuild/kilo
v0.0.1
Published
Freebuild sponsored model provider and sponsor panel for Kilo Code
Maintainers
Readme
Freebuild for Kilo Code
Kilo Code plugin that connects the Kilo CLI to the Freebuild broker and shows the sponsor panel during sponsored runs.
This is the Kilo beta. The CLI is the first target. The VS Code and JetBrains extensions can load the server plugin later, but the native panel is CLI only for now.
Install
kilo plugin @freebuild/kilo --globalRestart Kilo, then run:
/freebuild-licenseChoose 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_...or paste one with:
/freebuild-keyThe plugin verifies the key against the broker, saves it to ~/.config/freebuild/credentials.json, registers the freebuild provider, and sets the default model to freebuild/deepseek-flash.
If the model does not appear immediately, restart Kilo once. Kilo may need a fresh config load after the provider is added.
Use
/modelChoose:
Freebuild / DeepSeek V4.1 Flash 1017The provider sends:
Authorization: Bearer <license key>X-Freebuild-Install: <install id>X-Freebuild-Client: kilo/0.0.1
The license and install ID are shared with Freebuild for OpenCode and Freebuild for Pi.
Sponsor panel
The panel appears at the bottom of the Kilo TUI while a sponsored run is active. It uses the same server campaign, pending preview, click resolver, and wordmark as OpenCode.
SPONSOREDfor paid campaignsAFFILIATEfor affiliate campaignsFREEBUILDfor house inventoryADVERTISEfor house advertising inventory
Click the panel body to open the sponsor, or use alt+o:
/freebuild-sponsorThe loading and error panels are not clickable. Clicking uses the campaign currently drawn in the panel, so the brand and destination match.
Preview the campaign before a run:
/freebuild-adtestThe preview stores the campaign on the server. The next sponsored run consumes the same campaign, so the preview and the live panel match.
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 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 4 seconds
/freebuild-update Check for a new version and open the Kilo guide
/freebuild-status Show license, plan, model, install, and brokerEnvironment
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 keyDevelopment
From this repository:
kilo plugin "C:\Projects\freebuild\freebuild\kilo-plugin" --globalFor a project-scoped test:
kilo plugin "C:\Projects\freebuild\freebuild\kilo-plugin"Add the local package to a project config instead:
{
"plugin": ["file:///C:/Projects/freebuild/freebuild/kilo-plugin/src/tui.tsx"]
}The package has no build step. Kilo loads TypeScript through Bun.
Check the plugin load:
kilo --print-logs --log-level DEBUGLicense
Proprietary. Copyright (c) 2026 Freebuild. All rights reserved.
This package is licensed under the Freebuild Proprietary License. See LICENSE.
