Skip to main content
The Brickken CLI is the public terminal client for the Agentic API on Base. It prepares Brickken agentic transactions for free and pays the send through x402. In the recommended brickken-relayed mode, Brickken’s relayer signs and broadcasts the operation; in client-signed mode the CLI signs locally with your private key.

npm package

Install brickken-cli from npm.

GitHub repository

View the public source repository.

​
Install

npm install -g brickken-cli
brickken --version
brickken --help
You can also run it without a global install: 
npx brickken-cli --help

​
Authentication

The CLI is x402-only. It ignores BRICKKEN_API_KEY and BKN_API_KEY. 
export BRICKKEN_PRIVATE_KEY=0x...
BKN_PRIVATE_KEY is accepted as an alias. The private key signs the x402 payment, and — in client-signed mode only — the blockchain transaction. In brickken-relayed mode it signs the x402 payment only.
Never paste production private keys into shared terminals, tickets, or chat logs. Prefer environment variables or an .env file that is not committed.

​
Environments

EnvironmentBase URL
sandbox (default)https://api.sandbox.brickken.com
productionhttps://api.brickken.com
brickken --env sandbox --help
brickken --env production --help
Override the API base URL directly when needed: 
brickken --base-url https://api.sandbox.brickken.com --help

​
Network and RPC

Pass the target operation chain with --chain. Decimal and hex values are accepted. The Agentic API runs on Base, with Base Sepolia for tests.
NetworkDecimalHex
Base mainnet84530x2105
Base Sepolia845320x14a34
Ethereum Sepolia (legacy)111551110xaa36a7
Some commands, especially create-token --execute, wait for a deployment receipt to recover tokenAddress. Set an RPC URL for that lookup: 
export BRICKKEN_RPC_URL="https://sepolia.base.org"   # Base Sepolia
BKN_RPC_URL is accepted as an alias, or pass --rpc-url.

​
Command Model

High-level commands are prepare-only by default, and preparing is free. Add --execute to also send and pay the x402 charge in one step. Add --json for machine-readable output. The recommended path is brickken-relayed mode: pass --execution-mode brickken-relayed and omit --signer-address — Brickken’s relayer signs and broadcasts. The default is client-signed, where you provide --signer-address and the CLI signs the prepared transaction locally. 
# Prepare only (free), relayed mode
brickken create-token \
  --chain 84532 \
  --execution-mode brickken-relayed \
  --name "Research Agent Token" \
  --symbol RAGT

# Prepare + pay the send via x402, relayed mode
brickken create-token \
  --chain 84532 \
  --execution-mode brickken-relayed \
  --name "Research Agent Token" \
  --symbol RAGT \
  --execute \
  --json

​
Commands

CommandBackend methodPurpose
brickken agent registeragentRegisterRegister an ERC-8004 agent identity.
brickken agent set-uriagentSetURIUpdate an agent URI/profile.
brickken agent set-metadataagentSetMetadataWrite an agent metadata key/value.
brickken agent set-walletagentSetWalletUpdate the agent operational wallet.
brickken agent transfer-ownershipagentTransferOwnershipTransfer the ERC-8004 identity to a new owner.
brickken agent feedback giveagentGiveFeedbackSubmit reputation feedback.
brickken agent feedback revokeagentRevokeFeedbackRevoke feedback.
brickken agent feedback respondagentAppendFeedbackResponseRespond to feedback.
brickken create-tokenagentCreateTokenDeploy an agent-owned ERC-20 token.
brickken mintagentMintTokenMint an agent-owned token.
brickken burnagentBurnTokenBurn an agent-owned token.
brickken transferagentTransferTokenTransfer an agent-owned token.
brickken transfer-fromagentTransferFromTokenTransfer through allowance.
brickken approveagentApproveTokenApprove an allowance.
brickken tx prepare --method <method>any supported methodPrepare a raw backend method.
brickken tx signlocal onlySign prepared transaction JSON locally.
brickken tx sendPOST /send-transactionsSubmit signed transactions.
brickken tx statusGET /get-transaction-statusPoll transaction status.
brickken skill pathlocal onlyPrint the bundled Brickken AI-agent skill path.
brickken skill installlocal onlyInstall the bundled skill into an agent skills directory.

​
AI Agent Skill

The npm package includes a Brickken skill at skills/brickken, built on the open Agent Skills format and compatible with any agent that supports it — Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, and more. Use it when an AI agent needs to choose between the Dapp API, Agentic API, CLI, or MCP. For standalone installation without a global CLI install, see the Skill documentation. After installing brickken-cli, install the skill into the default skills directory (~/.codex/skills): 
brickken skill install
Or pass --path to target your agent’s skills directory (for example ~/.claude/skills for Claude Code, ~/.gemini/skills for Gemini CLI, ~/.cursor/skills for Cursor): 
brickken skill install --path ~/.claude/skills --force
To inspect where the bundled skill lives in the installed package: 
brickken skill path
Without a global install: 
npx brickken-cli skill install --path ~/.claude/skills --force

​
Agent Example

export CHAIN="84532"   # Base Sepolia

brickken agent register \
  --chain "$CHAIN" \
  --execution-mode brickken-relayed \
  --name "Research Agent" \
  --description "On-chain AI research agent" \
  --image https://example.com/agent.png \
  --service-name A2A \
  --service-endpoint https://agent.example/.well-known/agent-card.json \
  --ai-model-provider OpenAI \
  --ai-model-name "Research Model" \
  --x402-support true \
  --execute \
  --json

​
File Input

Use --file for nested JSON/YAML payloads, long metadata, or automation: 
brickken tx prepare \
  --method agentSetMetadata \
  --file metadata.json \
  --execute \
  --json
Preparing is free; only the send is x402-priced. Fund the wallet behind BRICKKEN_PRIVATE_KEY with enough USDC on the x402 payment chain (e.g. Circle USDC on Base Sepolia). In brickken-relayed mode Brickken’s relayer pays native gas; in client-signed mode you also need native gas on the operation chain.