Skip to main content

​
Using the CLI

1

Install and authenticate

# Install the CLI
cd cli && pnpm install && pnpm build
alias bx="node $(pwd)/dist/index.js"

# Log in (opens browser)
bx login
2

Create an agent

bx agents create my-agent
This provisions a sandboxed VM with Claude Code installed. It takes about 30 seconds.
3

Chat with your agent

bx agents chat my-agent "Write a Python script that prints hello world"
The response streams back in real-time.

​
Using the API

If you prefer to integrate directly, use the REST API with an API key.
1

Get an API key

Create one from the dashboard under Settings > API Keys, or with the CLI:
bx keys create --name "My Key"
Save the key — it’s only shown once.
2

Create an agent

curl -X POST https://api.boxcrew.ai/agents \
  -H "Authorization: Bearer bxk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "runtime": "claude-code"}'
3

Chat with your agent

curl -N -X POST https://api.boxcrew.ai/agents/my-agent/chat \
  -H "Authorization: Bearer bxk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "Write a Python script that prints hello world"}'
The response is an SSE stream:
data: {"type":"response.output_text.delta","delta":"Hello"}
data: {"type":"response.output_text.delta","delta":"! Here's"}
data: {"type":"response.completed"}

​
Next steps

CLI commands

Full reference for all bx commands.

API reference

Complete REST API documentation.