Brokr Documentation

One command, no signup. Brokr compiles intent into working infrastructure — repo, database, deployment, storage, AI — provisioned instantly. Humans and AI agents create stacks the same way.

Introduction

Brokr is an intent compiler for infrastructure. One command provisions the repo, deployment target, database, storage, and the provider wiring around them — no account required.

That's the point. AI agents, scripts, and first-time users can create fully provisioned stacks without signing up. Brokr creates a temporary stack, writes credentials to .env, and gives you a 7-day window to claim it. Log in whenever you want — or don't, and let it expire.

Brokr accepts canonical CLI syntax, expressive aliases, and natural language. All three routes compile into the same structured plan.

Installation

bash

npm install -g @brokr/cli
# or
pnpm add -g @brokr/cli

Verify your environment is ready:

bash

brokr doctor
# ✓ Node.js v20.11.0
# ✓ API reachable at https://api.brokr.sh
# ✓ Ready to create stacks (no login required)

That's the only prerequisite. No account, no API keys, no config files. Run brokr create and go.

Quick Start

Install the CLI and create a stack. No signup, no login, no config.

bash

npm install -g @brokr/cli
 
# From a repo with a GitHub remote — name auto-detected, no login needed
cd ~/my-project
brokr create web-app
# ✓ Stack created   →  tmp_abc123 (temporary — 7 days to claim)
# ✓ .env.brokr     →  BROKR_TOKEN + secrets written
# ✓ .brokr written →  run `brokr claim` or `brokr link account` to keep it
#   Provisioning:   https://my-project.brokr.sh

That's it. Your stack is provisioned with a database, deployment target, and all the wiring. The .env is written, the repo is connected, and https://my-project.brokr.sh is live as soon as provisioning finishes.

AI agents and scripts can create stacks programmatically — no interactive auth flow needed. This is by design. Agents create, humans claim later.

Scaffold from a template if you don't have existing code:

bash

brokr create cipher --name my-chat
# ✓ Template scaffolded  →  ./my-chat/
# ✓ Stack created        →  tmp_abc123 (temporary — 7 days to claim)
# ✓ .brokr written       →  run `brokr claim` to make permanent

When you're ready to deploy:

bash

brokr deploy --watch
#   ✓ Code pushed      →  https://github.com/brokr-infra/my-chat
#   ✓ Env synced       →  8 vars pushed to Vercel
#   ✓ Deploy triggered →  dpl_abc123
#   ✓ Ready            →  https://my-chat.brokr.sh  (1m 12s)

Authentication

Authentication is optional. You can create and deploy stacks without ever logging in. But when you're ready to make stacks permanent, manage billing, or access the dashboard, link your GitHub account:

bash

brokr link account
# Opens browser → GitHub OAuth → writes ~/.brokr/credentials.json
# ✓ Logged in as you@example.com
#   ✓ Auto-claimed: my-project  →  matched https://github.com/you/my-project

When you log in, Brokr cross-references your GitHub repos against any temporary stacks created from your machine and auto-claims them. No manual step needed — if you created stacks anonymously from repos you own, they're yours now.

You can also claim a specific stack manually:

bash

# From the stack directory (reads .brokr file)
brokr claim
 
# Or by stack ID
brokr claim tmp_abc123

Authenticated stacks are permanent — no 7-day expiry. They appear in your dashboard, support billing, team members, and custom domains.