Try Bunkhouse with your coding agent
An agent trial lets you see Bunkhouse on a page of your own without an account, card or model API key. Your coding agent (for example Claude Code, Codex or Cursor) creates a disposable trial and then acts as the assistant’s model: each turn the page needs is passed to the agent, and the agent’s reply is streamed back to the page.
What you need
Section titled “What you need”- A coding agent that can run shell commands and make HTTP requests, for example with
curl. - A dummy web page with disposable data, served over HTTP at a fixed origin such as
http://localhost:3000. A static list with a small form is enough. The origin must be HTTPS, or HTTP onlocalhost,127.0.0.1or[::1];file://pages and LAN addresses are not accepted. - A browser to open that page.
No Bunkhouse account, email address, card or model provider key is needed. Bunkhouse does not call or bill a model for trial turns.
Ask your agent
Section titled “Ask your agent”Copy this instruction into your coding agent, changing the address if your page runs elsewhere:
Read https://api.bunkhouse.ai/agent-trial.md and follow it to run a Bunkhouse agent trial on my dummy page at http://localhost:3000.https://api.bunkhouse.ai/agent-trial.md is the machine-readable guide and the authoritative description of the trial protocol. The agent creates an anonymous trial identity, registers your page’s origin, adds the generated script tag to the page and then serves the assistant’s turns. Follow that guide rather than this page for exact requests; it is kept current with the service.
Using the trial
Section titled “Using the trial”- Open the page and the Assistant launcher.
- Read the disclosure and accept it. It names the agent controlling the trial as the recipient of your messages, page controls and data the assistant reads.
- Send a message and let your agent answer it. Writes to the page or its API still ask for your approval.
Use dummy data only: everything the assistant reads is sent to the agent through the service.
How you know it worked
Section titled “How you know it worked”- Creating the trial returns a
publicKeyand anembedSnippetfor your page’s origin. - After your agent adds the snippet and you reload the page, the Assistant launcher appears.
- After you accept the disclosure and send a message, your agent picks up the turn and its answer appears in the pane.
- When your agent asks the page to change something, an approval dialog appears before anything is written.
- When the agent finishes its reply, the pane shows Done.
If the launcher does not appear, check that the page is served from exactly the registered origin (localhost and 127.0.0.1 are different origins, and so are different ports) and that any Content Security Policy allows the embed and API origins listed in the machine-readable guide.
Limits
Section titled “Limits”| Limit | Value |
|---|---|
| Lifetime | 24 hours |
| Turns | 100 in total |
| Outstanding turns | One at a time |
| Time to answer a turn | 240 seconds |
| Origins | One page origin, plus up to 4 API origins |
| Trials per identity | One |
Your agent can revoke the trial at any time. Expired and revoked trials are deleted about an hour later, together with the anonymous identity. A trial never converts into a paid account automatically; to keep using Bunkhouse with hosted inference, create an account and follow the quickstart. See billing for plan terms.
Measurement and test trials
Section titled “Measurement and test trials”Bunkhouse counts how many trials are created. The count records that a trial was created, not your page origin, messages or identity. The Bunkhouse team also runs its own synthetic trials to check that this guide and the protocol keep working; those are tagged on our server when they are created and are excluded from the count.