CLI
Overview
Introduction to the BuildBear CLI and its capabilities
The BuildBear CLI (buildbear) lets you manage sandboxes, fund wallets, take snapshots, inspect contracts, and interact with your BuildBear environment directly from the terminal — no browser required.
What you can do
- Create and manage sandboxes — fork any supported network at any block, list your sandboxes, and delete them when done
- Fund wallets instantly — drop native tokens (ETH, MATIC, etc.) or mint ERC-20 tokens to any address
- Snapshot and revert state — take point-in-time snapshots of your sandbox and revert to them for repeatable test runs
- Inspect smart contracts — fetch verified source code and ABIs, or verify your own contracts
- Send raw JSON-RPC calls — call any RPC method directly against a sandbox
- Initialize projects — run
buildbear initto create a.buildbear.jsonconfig file and wire up a sandbox for your project
Command groups
| Command | Description |
|---|---|
buildbear auth | Manage authentication and API keys |
buildbear init | Interactive project initialization |
buildbear sandbox | Create, list, delete, and list supported networks |
buildbear status | Check sandbox health (live / pending / dead) |
buildbear faucet | Fund native and ERC-20 tokens |
buildbear snapshot | Take and revert sandbox state snapshots |
buildbear contract | Fetch source code, ABI, or verify contracts |
buildbear rpc | Direct JSON-RPC passthrough |
Global flags
| Flag | Short | Description |
|---|---|---|
--version | -v | Print the CLI version |
--help | -h | Show help for any command |
Run buildbear --help or buildbear <command> --help at any time for inline documentation.
Output modes
Most commands support two output flags that can be combined with scripts and CI pipelines:
--json— emit structured JSON instead of formatted text--quiet— suppress all output except errors
See Output Modes for details and examples.