Beta Freebuild is in beta. Lite and Standard are available now. Freebuild beta. Lite and Standard are available. Tell us what to fix
freebuild. docs beta
See pricing
Freebuild for OpenCode, Pi, and Kilo

Install, connect, and use the plugin.

Everything from the first install to the token limit, the sponsor panel, billing, and the errors you are most likely to hit.

Install

Choose your path.

Both paths use the same plugin. The difference is where you pay. The website sells the license. It does not install the plugin. OpenCode uses @freebuild/opencode; Pi uses @freebuild/pi; the Kilo CLI uses @freebuild/kilo. The license and install ID are shared.

Open the step-by-step OpenCode install guide with screenshots.

Open the Freebuild for Pi guide for the Pi install command, commands, and panel behavior.

Open the Freebuild for Kilo guide for the Kilo CLI install command, commands, and panel behavior.

Quick start

Two paths, one plugin.

Terminal-first Install, restart, /freebuild-license, verify email, checkout, auto-connect, /models, /freebuild-plan.
Browser-first Install, restart, buy on the pricing page, verify email, checkout, /freebuild-key, /models, /freebuild-plan.
Terminal checkout connects the key automatically. Browser checkout gives you a key to paste with /freebuild-key. /freebuild-setup is a repair command, not a required step. Lite is $5/month for 30M weighted tokens. Standard is $9.50/month for 60M, first month $5.

Requirements

  • OpenCode V2 with plugin support, a current Pi release, or Kilo CLI 7.8 or later.
  • macOS, Linux, or Windows.
  • A Freebuild Lite, Standard, or founding beta license. You can install the plugin before you buy.
  • Network access to https://freebuild.dev/broker.

Install

opencode plugin add @freebuild/opencode@latest

Restart OpenCode so the plugin loads.

For Pi, install the Pi package instead:

pi install npm:@freebuild/pi@latest

Restart Pi so the extension loads. See the Freebuild for Pi guide.

For the Kilo CLI, install the Kilo package:

kilo plugin @freebuild/kilo --global

Restart Kilo so the plugin loads. See the Freebuild for Kilo guide.

Both purchase paths require this plugin. The website sells the license. It does not install the plugin. See the screenshot guide for the terminal-first and browser-first paths.

Update

opencode plugin update

Restart OpenCode after updating.

Remove

opencode plugin remove @freebuild/opencode

Removing the plugin does not cancel your subscription. Cancel billing separately from the account page or the Stripe portal.

Plans and pricing

PlanPriceToken budgetHow to get it
Lite$5/month30M weighted tokensTerminal or browser checkout
Standard$9.50/month, first month $560M weighted tokensTerminal or browser checkout

There is no free tier and no ad-free tier. Both plans include the sponsor panel.

Terminal-first checkout

/freebuild-license

Verify your email, choose Lite or Standard, finish Stripe Checkout, then return to OpenCode. The plugin receives the key automatically and selects the Freebuild model.

Browser-first checkout

Open the pricing page, choose Lite or Standard, and pay in the browser. After checkout, copy the key from the success page or open the one-time license link we send to the verified email.

The website does not install the plugin. If you have not installed it yet, run:

opencode plugin add @freebuild/opencode@latest

Restart OpenCode, then run /freebuild-key and paste the key.

We verify the email before checkout with a 6-digit code, so a typo cannot attach the license to the wrong address.

You can compare both plans on the pricing page.

Already have a key?

Connect it with /freebuild-key. This is also the path for a replacement key from the account page.

Connect

If you bought in the browser, this is the required step. If you started from the terminal, the plugin already connected the key and you can skip to Use.

/freebuild-key
The automatic connect in /freebuild-key requires a current @freebuild/opencode plugin. Run opencode plugin update if you are on an older version.

Paste the key from the account page or the one-time license link we sent to your verified email.

On a current plugin, this writes the provider config, connects the credential, and selects the Freebuild model. You should see:

  • Provider configured and Freebuild model selected.
  • The Freebuild model available in /models.
  • The plan and token limit in /freebuild-plan.

If the provider is missing

Run the repair command, then restart OpenCode. This is repair, not a required setup step:

/freebuild-setup

If Freebuild is still missing, run the key command again and restart OpenCode:

/freebuild-key

If the provider is still missing, restart OpenCode once. The running service may still be using the old provider list.

Use

Select the model:

/models

Choose Freebuild and DeepSeek V4.1 Flash 1017.

Set the thinking level:

/thinking

Run a prompt. The sponsor panel appears while the agent works and remains clickable for the run.

Check usage at any time:

/freebuild-plan

Commands

CommandWhat it does
/freebuild-licenseConnect, reconnect, replace, or buy a license.
/freebuild-keyPaste and validate an existing key.
/freebuild-planShow the plan label, weighted used and limit, raw tokens, cache hit rate, and reservations. The billing period is on the account page.
/freebuild-setupRepair the provider config and select the model.
/freebuild-billingOpen the Stripe customer portal.
/freebuild-adtestPreview the next run's sponsor panel for about 4 seconds.
/freebuild-sponsorOpen the sponsor panel manually.
/modelsChoose the model for the current session.
/thinkingSet the DeepSeek thinking level.

Pi uses /model instead of /models and has the same Freebuild commands. See the Pi command list. The Kilo CLI uses /model and the same Freebuild commands. See the Kilo command list.

Plans and limits

PlanMonthly limitReset
Lite30,000,000 weighted tokensStart of each billing period
Standard60,000,000 weighted tokensStart of each billing period

Founding beta uses a 10,000,000 weighted-token monthly limit.

Tokens are weighted:

  • Cached input counts at 2%.
  • Fresh input counts at 100%.
  • Output counts at 400%.

Long sessions with high cache hits go much further than their raw token counts suggest. Unused tokens do not roll over. When the monthly limit is reached, the broker rejects further model calls until the next billing period.

At a 96% cache hit rate, the 60M Standard budget is about 1B raw input tokens. At 98%, about 1.5B. At 99%, about 2B. For Lite, those are about 507M, 758M, and 1.01B. These examples assume all input and no output. Output weighs 4x and fresh input weighs 1x, so real usage is lower.

The account page and /freebuild-plan show raw tokens and cache hit rate next to weighted usage.

Account and billing

Open the account page:

https://freebuild.dev/account

Sign in with the email used at checkout. From the account page you can reveal the key, rotate a stolen key without losing the remaining quota, and open the Stripe billing portal.

To manage billing from the terminal:

/freebuild-billing

Founding beta

Founding beta is a private, invite-only test. It is not a public free tier. Invited testers get 90 days with 10,000,000 weighted tokens per billing month and the sponsor panel.

Founding beta uses the same checkout as Lite and Standard, free for 90 days. Install the plugin, run /freebuild-founding, paste your private code, and complete the free Stripe checkout. The plugin connects the license automatically.

The subscription cancels automatically at day 90, before any charge. When it ends, continue on Lite or Standard with /freebuild-license.

Already claimed a code under the old flow? Use /freebuild-key with the key from your welcome email.

Founding code errors

code_used means the code was already claimed. email_used means that email already has founding access. code_invalid means the code is not in the current cohort. code_reserved means another checkout is already using the code.

Troubleshooting

install_mismatch

The license is bound to a different OpenCode install. This usually happens when an old opencode serve --service process is still running with the previous install ID.

Close every OpenCode window, make sure no opencode process remains, and open it again. Then run /freebuild-plan.

install_required

The request did not include the install ID. Reinstall the plugin, restart OpenCode, and run /freebuild-key again.

Freebuild is missing from /models

The running service has not loaded the provider config. Run /freebuild-setup, then restart OpenCode.

Model is missing from /models

Check Recent first. OpenCode moves recently used models out of their provider groups. You can also type Freebuild to search. If it is still missing, run /freebuild-setup, then restart OpenCode once.

401 or invalid license

The key was revoked, rotated, or the subscription is inactive. Get the current key from /account and paste it with /freebuild-key.

Broker unreachable

Check your network and the service status. The plugin keeps the panel closed when the broker cannot be reached.

No sponsor panel

The panel requires an active sponsored license. Use /freebuild-plan to confirm the license is active. Use /freebuild-adtest to preview the next run's panel.

Sign-in email does not arrive

Check spam and confirm you are using the same email as checkout. Request a new link from /account. Links expire and work once.

Checkout fails

Try another card or payment method. If Stripe rejects the session, start again with /freebuild-license. Do not open several checkouts at once.

Privacy and security

  • The license key is a bearer credential. Anyone with it can use the quota.
  • Never post the key in a public channel or commit it to a repository.
  • If the key leaks, rotate it from /account. The new key keeps the remaining quota and billing.
  • Prompts and code are not sent to advertisers.
  • Read the privacy policy for how the model provider processes requests: /privacy.html.

Freebuild is not built by the OpenCode team and is not affiliated with OpenCode.

FAQ

Which plan should I choose?

Lite is $5/month for 30M weighted tokens. Standard is $9.50/month for 60M, with the first month at $5. Standard gives you twice the monthly budget.

Is there a free tier?

No. Lite and Standard are paid plans. The founding beta is a private 90-day comp for invited testers, not a public free tier.

Can I remove the sponsor panel?

No. The panel is part of every plan, including the founding beta.

Can I use my own API key?

The Freebuild plugin connects the Freebuild broker. You can configure other providers in OpenCode separately, but they are outside this plan.

Can I use one license on two machines?

One license binds to one install ID. Rotate the key from /account to move it to a new machine. Do not run two active installs on the same key.

What happens when I cancel?

The subscription stops renewing. Access continues until the end of the paid period. After that the broker rejects requests and the sponsor panel closes.

Do you support Pi?

Pi is in beta and not part of the public OpenCode flow yet.

Where do I report a bug?

Use the contact page and include the command, the error text, and your plugin version.

Still stuck?

Send the exact error.

Include the command you ran, the full error text, your OpenCode version, and your plugin version. Do not include your license key.