BeastMode CLI

The command-line interface for BeastMode -- turn natural language intent into verified software.

Install

npm install -g @beastmode-develeap/beastmode

Requires Node.js >= 20.

Quick Start

# Initialize a new factory
beastmode init

# Launch the web dashboard
beastmode board

# Check factory status
beastmode status

# Run a single pipeline task
beastmode run --task "Add user authentication"

# Start the daemon (continuous pipeline)
beastmode daemon

# Docker orchestration (image mode)
beastmode up                    # Start services (docker compose up)
beastmode down                  # Stop services (docker compose down)
beastmode logs [service]        # Stream service logs
beastmode update [--tag 1.2.3]  # Pull latest images and restart

# Migrate from daemon config
beastmode migrate --config config/beastmode.daemon.json

Commands

| Command | Description | |---|---| | beastmode init | Initialize factory (auto-detects source vs image mode) | | beastmode board | Launch the web UI (dashboard, kanban, chat) | | beastmode status | Show factory status overview | | beastmode run --task "..." | Run a single pipeline task | | beastmode daemon | Start the daemon (polls for tasks) | | beastmode migrate | Migrate existing daemon config to factory format | | beastmode mcp | Start the MCP server (stdio transport) | | beastmode config get <key> | Read a config value | | beastmode config set <key> <value> | Set a config value | | beastmode add plugin <source> | Install a plugin | | beastmode add mcp <name> | Register an MCP server | | beastmode list | List extensions (plugins, MCPs, hooks, skills) | | beastmode doctor | Run diagnostics (includes GHCR auth check) | | beastmode validate | Validate factory configuration | | beastmode upgrade | Check for and apply schema upgrades | | beastmode export | Export factory config | | beastmode import | Import artifacts (PRD, user stories, etc.) | | beastmode up [--pull] | Start BeastMode services | | beastmode down [--volumes] | Stop BeastMode services | | beastmode logs [service] | Stream service logs (board, ui, daemon) | | beastmode update [--tag ver] | Pull latest images and restart | | beastmode deploy [--cloud aws] | Deploy as systemd services or to AWS | | beastmode sync-claude-creds | Sync Claude Code creds for Docker (macOS) | | beastmode project add <path> | Register a project repository | | beastmode project list | List registered projects |

MCP Integration

BeastMode exposes a Model Context Protocol (MCP) server with 14 tools for managing factories, running pipelines, and inspecting results. Any AI assistant with MCP support can use it.

# Start the MCP server
beastmode mcp

# Use as an MCP server in Claude Code
claude --mcp "beastmode:beastmode mcp"

Chat UI

The board web UI includes a chat page (#/chat) that spawns a Claude Code subprocess with the BeastMode MCP server. Talk to your factory using natural language -- create tasks, check status, manage extensions, and run pipelines.

Documentation

• Getting Started -- step-by-step guide from zero to first pipeline run
• Plugin Development -- create custom plugins for BeastMode

License

MIT