Skip to content

CLI Reference

All Baize management happens through the baize CLI.

Core commands

bash
baize init                    # Set up the Baize environment
baize config get <key>        # Read a config value
baize config set <key> <val>  # Write a config value
baize attach                  # Attach to the agent tmux session (Ctrl+B d detach)
baize shell                   # Interactive CLI
baize runtime <name>          # Switch AI runtime (claude | codex)
baize runtime status          # Show the currently configured runtime
baize doctor                  # Diagnose and auto-repair the installation
baize status                  # Check running services
baize logs [service]          # View service logs

Component management

bash
baize add <component>         # Install a channel or capability
                              #   --registry <url>   temporary npm source
                              #   --branch <name>    install from a git branch
                              #   --file <tar.gz>    offline delivery (verified)
baize upgrade <component>     # Upgrade a component (official npm channels via npm)
baize upgrade --all           # Upgrade all components
baize upgrade --self          # Upgrade baize-core itself
baize list                    # List installed components
baize search [keyword]        # Search the dynamic channel catalogue
baize uninstall <name>        # Remove a component (--purge also deletes data)
baize uninstall --self        # Uninstall Baize entirely

A2A commands

bash
baize a2a status                              # Local state: enabled / agent_id / registration / advertise_url
baize a2a enable --admin <url> --advertise <url>  # Enable A2A and register with the admin
baize a2a disable                             # Disable (already-accepted tasks keep running)
baize a2a peer list                           # Cached peers
baize a2a search <query>                      # Discover agents via the admin directory
baize a2a card <id>                           # Agent Card details
baize a2a session-summary                     # Summary of currently available peers
baize a2a send <peer> <text>                  # Plain message (no reply wait)
baize a2a task <peer> <skill> "<instruction>" # Delegate a task; sync wait by default
                                              #   --async returns the task_id only
baize a2a task status <task_id>               # Query a delegated task
baize a2a task cancel <task_id>               # Cancel a delegated task

See A2A Collaboration for the full lifecycle and protocol.