CLI Reference

Complete AgileBuilder CLI command reference

Overview

This document covers all commands and options available in the AgileBuilder CLI.


Global Options

agilebuilder [command] [options]

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

Command List

generate

Generate a project from a template.

agilebuilder generate <template> <output> [options]

Arguments:
  template    Template name or path
  output      Output directory

Options:
  -y, --yes              Skip confirmation prompts
  --no-hooks             Do not execute hooks
  --var <key=value>      Specify variable values

Examples:
  agilebuilder generate react-starter my-app
  agilebuilder generate react-starter 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 a template
  create <path>          Create template from existing project
  info <name>            View template details
  update <name>          Update a template
  sync                   Sync cloud templates

template add

agilebuilder template add <url> [options]

Options:
  --name <name>         Specify template name
  --branch <branch>     Specify Git branch
  --team <team>         Add to team

template create

agilebuilder template create <path> [options]

Options:
  --name <name>         Template name
  --desc <description>  Template description
  --include <pattern>   Files to include
  --exclude <pattern>   Files to exclude

ui

Start the local web-based management interface.

agilebuilder ui [options]

Options:
  -p, --port <port>    Specify port (default: 3456)
  --no-open             Do not open browser automatically

mcp

MCP service management.

agilebuilder mcp <subcommand>

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

mcp start

agilebuilder mcp start [options]

Options:
  -p, --port <port>     Specify port (default: 3457)
  --daemon              Run in background

config

Configuration management.

agilebuilder config <subcommand>

Subcommands:
  list                   List all configurations
  get <key>              Get configuration value
  set <key> <value>      Set configuration value
  reset                  Reset to defaults

login / logout

Account login and logout.

agilebuilder login [options]
agilebuilder logout

Options:
  --email <email>        Specify login email

subscription

Subscription management.

agilebuilder subscription <subcommand>

Subcommands:
  status                 View subscription status
  renew                  Renew subscription
  cancel                 Cancel subscription

team

Team management.

agilebuilder team <subcommand>

Subcommands:
  list                   List teams you're in
  create <name>          Create a team
  invite <email>         Invite a member

workflow

Workflow management.

agilebuilder workflow <subcommand>

Subcommands:
  list                   List workflows
  run <name>             Execute a workflow
  export <name>          Export a workflow
  import <path>          Import a workflow

Environment Variables

VariableDescriptionDefault
AGILEBUILDER_HOMEData directory~/.agilebuilder
AGILEBUILDER_PORTUI port3456
AGILEBUILDER_MCP_PORTMCP port3457
AGILEBUILDER_TOKENAuth token-

Exit Codes

CodeDescription
0Success
1General error
2Invalid arguments
3Template not found
4Generation failed
5Authentication failed
6Network error

Configuration File

The CLI configuration file is located at ~/.agilebuilder/config.json:

{
  "templateDir": "~/my-templates",
  "defaultPackageManager": "pnpm",
  "mcpPort": 3457,
  "uiPort": 3456,
  "logLevel": "info"
}