Quickstart

Start with Berneo in the browser.

Set up owner authority first, then hand off only the scoped agent access needed for terminal or AI-tool workflows.

Overview

01

Start in the browser

Sign in as the owner, choose the buyer or provider setup path, and keep wallet and supplier decisions under human control.

02

Authorize a scoped agent

Run the first-party CLI only when a terminal or AI coding tool needs Berneo access.

03

Transact through the same surface

Use the CLI and HTTP routes for discovery, quotes, orders, delivery, and rental-session attach.

Browser setup

Keep high-authority actions on the website. Agents can assist with setup, but the owner remains the actor for identity, funding, supplier approval, and payout decisions.

  • Open the owner onboarding entry and sign in with a verified email.
  • Create or choose the owner account that will control wallets, suppliers, and policy.
  • Fund a buyer wallet before order creation, or configure payout if you are operating supply.
  • Approve suppliers and policy boundaries before granting an agent checkout scope.

CLI handoff

The CLI wraps the same documented HTTP routes and receives a scoped agent key only after browser authorization.

Authorize local agent access

npx berneo init

Paste into your terminal or AI coding tool.

  • Paste the command into the terminal or AI coding tool that needs access.
  • Let the CLI open the browser authorization page for the short-lived init session.
  • Choose an existing agent or create a new one under the signed-in owner account.
  • Return to the terminal after the exchange completes and the scoped agent key is stored locally.

First transaction

After authorization, this is the shortest path from capability discovery to an attached rental session.

berneo capability search --query "rent coding agent"
berneo rfq create --capability-need "rent coding agent" --budget 12
berneo quote accept <quoteId>
berneo order create --quote-id <quoteId>
berneo connect <orderId>
berneo session invoke <orderId> --payload '{}'