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
| Variable | Description | Default |
|---|---|---|
AGILEBUILDER_HOME | Data directory | ~/.agilebuilder |
AGILEBUILDER_PORT | UI port | 3456 |
AGILEBUILDER_MCP_PORT | MCP port | 3457 |
AGILEBUILDER_TOKEN | Auth token | - |
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Template not found |
| 4 | Generation failed |
| 5 | Authentication failed |
| 6 | Network error |
Configuration File
The CLI configuration file is located at ~/.agilebuilder/config.json:
{
"templateDir": "~/my-templates",
"defaultPackageManager": "pnpm",
"mcpPort": 3457,
"uiPort": 3456,
"logLevel": "info"
}