CLI Reference

The bee CLI is the primary interface for managing agents, running Bee Worker, and interacting with Bee Hive from the command line.

Installation

macOS / Linuxbash
curl -fsSL https://get.beesystem.ai | sh

Commands

bee init

bee init <name>                    # Create new agent project
bee init <name> --template <t>     # From template

bee worker

bee worker start                   # Start runtime
bee worker start --config <path>   # With config file
bee worker stop                    # Graceful stop
bee worker status                  # Runtime status
bee worker logs                    # Stream logs

bee agent

bee agent run --spec <path> --task "..."   # Run agent
bee agent list                                # List agents
bee agent validate --spec <path>             # Validate spec
bee agent logs <run-id>                      # Run logs

bee tool

bee tool list                      # List available tools
bee tool test <name> --input <json> # Test a tool

bee hive

bee hive start                     # Start Bee Hive
bee hive status                    # Hive status
bee hive workers                   # List worker pool
bee hive task submit               # Submit task

Global flags

FlagDefaultDescription
--configautoConfig file path
--log-levelinfodebug, info, warn, error
--log-formattexttext, json
--worker-addrlocalhost:7433Bee Worker address