BeeAI command-line interface (CLI) provides powerful tools to discover, run, and manage agents directly from your terminal. This document serves as a comprehensive reference for all available commands and options.

Basic Usage

The basic syntax for BeeAI commands follows this pattern:
beeai [command] [subcommand] [arguments] [options]
To see a list of all available commands:
beeai --help

Core Commands

List

List all available agents:
beeai list
This displays a table with agent names, statuses, descriptions, UI types, locations, missing environment variables, and error messages.

Run

Run an agent with specified input:
beeai run <agent-name> [input]
Examples:
# Run chat agent interactively
beeai run chat

# Run agent with direct input
beeai run chat "Hello!"

# Run agent with input from file
beeai run chat < input.txt

# Pipe between agents
beeai run gpt_researcher "Latest AI developments" | beeai run chat "Summarize in 3 points"

Info

Get detailed information about a specific agent:
beeai info <agent-name>
Shows details including description, input/output schemas, examples, configuration options, and provider information.

Add

Add an agent to your environment:
beeai add <location>
# Aliases: install
Use beeai add when:
  • You want to use an agent (one-step process)
  • You don’t care about build details
  • You want the simplest workflow
Location formats:
# From Docker image
beeai add ghcr.io/i-am-bee/beeai-platform/community/aider:latest

# From GitHub repository
beeai add "https://github.com/i-am-bee/custom-agent"

# From GitHub with version
beeai add "https://github.com/i-am-bee/custom-agent#v1.0.0"

# From GitHub with specific path
beeai add "https://github.com/i-am-bee/repo#:agents/my-agent"

# From local path (builds Docker image)
beeai add ./my-agent-directory

Remove

Remove an agent from your environment:
beeai remove <agent-name>
# Aliases: uninstall, rm, delete

Logs

View and follow the logs for an agent:
beeai logs <agent-name>
This displays the agent’s log output and continues streaming new logs as they are generated.

Build

Build an agent from a local directory or repository:
beeai build [context]
Arguments:
  • context: Docker context for the agent (default: current directory)
Options:
  • --tag <name>: Docker tag for the agent
  • --multi-platform: Build for multiple platforms
  • --import / --no-import: Import the image into BeeAI platform (default: true)
Use beeai build when:
  • You want to test builds before using them (--no-import)
  • You need custom build options (--multi-platform, custom --tag)
  • You’re developing and want to control the build process
  • You want to build images for sharing (not immediate use)
Examples:
# Build from current directory
beeai build .

# Build with custom tag
beeai build . --tag my-agent:latest

# Build without importing
beeai build . --no-import

# Build from GitHub URL
beeai build "https://github.com/user/repo"

Environment Management

Environment Setup

Interactive setup for LLM provider environment variables:
beeai env setup
This guides you through setting up the required environment variables for your chosen LLM provider.

Environment Variables

Manage environment variables for agents:
# List all environment variables
beeai env list

# Add or update an environment variable
beeai env add KEY=VALUE

# Remove an environment variable
beeai env remove KEY
Examples:
# Set up an OpenAI-compatible API
beeai env add LLM_MODEL=gpt-4o
beeai env add LLM_API_BASE=https://api.openai.com/v1
beeai env add LLM_API_KEY=sk_...

System Commands

Start

Start the BeeAI server:
beeai platform start

Stop

Stop the BeeAI server:
beeai platform stop

Delete

Delete the BeeAI server:
beeai platform delete

UI

Launch the web interface:
beeai ui
This runs the server in the foreground.

Version

Display version information:
beeai version
Shows versions of:
  • beeai-cli
  • beeai-server
  • acp-sdk

Global Options

Most commands support these general options:
  • --help: Show help information for a command
  • --debug: Enable debug output for troubleshooting