AgileBuilder logoAgileBuilder
Back to docs

CLI Reference

AgileBuilder command-line tool complete documentation

This document contains all AgileBuilder CLI commands and options.

Global Options

agilebuilder [command] [options]

Options:
  -v, --version    Show version
  -h, --help       Show help
  --verbose        Show detailed logs
  --no-color       Disable colored output

Commands

ui

Start local management interface:

agilebuilder ui [options]

Options:
  -p, --port <port>    Specify port (default: 3456)
  --no-open            Don't auto-open browser

generate

Generate project from template:

agilebuilder generate <template> <output> [options]

Arguments:
  template    Template name or path
  output      Output directory

Options:
  -y, --yes              Skip confirmation
  --no-hooks             Don't execute hooks
  --var <key=value>      Specify variable (can use multiple)

Example:

# Interactive generation
agilebuilder generate react-starter my-app

# Non-interactive generation
agilebuilder generate react-starter my-app \
  --var projectName=my-app \
  --var useTypeScript=true \
  -y

template

Template management commands:

agilebuilder template <subcommand>

Subcommands:
  list                   List all templates
  add <url>              Add template from Git URL
  remove <name>          Remove template
  create <path>          Create template from existing project
  info <name>            View template details
  update <name>          Update template

mcp

MCP service management:

agilebuilder mcp <subcommand>

Subcommands:
  start                  Start MCP service
  stop                   Stop MCP service
  status                 View service status

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | AGILEBUILDER_HOME | Data directory | ~/.agilebuilder | | AGILEBUILDER_PORT | UI port | 3456 | | AGILEBUILDER_MCP_PORT | MCP port | 3457 |

Exit Codes

| Code | Description | |------|-------------| | 0 | Success | | 1 | General error | | 2 | Argument error | | 3 | Template not found | | 4 | Generation failed |

Next Steps