@amaster.ai/runtime-cli

Unified CLI for Amaster SDK and OpenClaw integration. Manage entities, BPM processes, workflows, S3 files, authentication, and OpenClaw skills from a single command-line interface.

Features

• Authentication: Login, logout, register users, manage sessions
• Entity Management: CRUD operations on entities with type-safe API
• BPM: Manage Camunda processes, tasks, and instances
• Workflow: Execute and monitor workflows
• S3 Storage: Upload, download, list, and manage files
• OpenClaw Integration: Initialize app-specific skills and MCP servers for AI assistants

Installation

npm install -g @amaster.ai/runtime-cli

Or use with npx:

npx @amaster.ai/runtime-cli

Automatic Cleanup

When you uninstall @amaster.ai/runtime-cli, it will automatically clean up the OpenClaw integration for the configured app:

npm uninstall -g @amaster.ai/runtime-cli
# Automatically removes skills and MCP servers

To skip automatic cleanup:

npm_config_ignore_scripts=1 npm uninstall -g @amaster.ai/runtime-cli

Quick Start

1. Configure the CLI

# Set your API key
amaster config set apiKey YOUR_API_KEY

# Set base URL (optional, defaults to https://api.amaster.ai)
amaster config set baseURL https://api.amaster.ai

# View configuration
amaster config list

2. Authenticate

# Login
amaster login

# Or with options
amaster login --email [email protected] --password secret

# Check who you are
amaster whoami

3. Use SDK Features

# List entities
amaster entity list myapp users

# Get a specific entity
amaster entity get myapp users 123

# Create an entity
amaster entity create myapp users --data '{"name":"John","email":"[email protected]"}'

# List BPM processes
amaster bpm processes

# Start a process
amaster bpm start my-process --variables '{"key":"value"}'

# List workflows
amaster workflow list

# Execute a workflow
amaster workflow execute my-workflow --input '{"data":"value"}'

# List S3 files
amaster s3 list

# Upload a file
amaster s3 upload ./myfile.pdf --bucket mybucket --key documents/myfile.pdf

4. Setup OpenClaw Integration

Initialize OpenClaw integration for a specific app (downloads app-specific skills and MCP servers):

# Initialize for an app
amaster init --app-code myapp

# With API key
amaster init --app-code myapp --api-key YOUR_API_KEY

# Force reinitialize
amaster init --app-code myapp --force

Check integration status:

amaster doctor

List installed components:

amaster list

Switch to a different app:

amaster switch another-app

Remove integration for current app:

amaster uninstall --yes

Commands

Configuration

amaster config set <key> <value>    # Set config value
amaster config get <key>            # Get config value
amaster config list                 # List all config

Authentication

amaster login [options]             # Login with email/password
amaster logout                      # Logout
amaster whoami                      # Show current user
amaster register [options]          # Register new user
amaster users [options]             # List users

Entity Management

amaster entity list <app> <entity> [options]
amaster entity get <app> <entity> <id>
amaster entity create <app> <entity> [options]
amaster entity update <app> <entity> <id> [options]
amaster entity delete <app> <entity> <id>
amaster entity types <app>

BPM

amaster bpm processes               # List process definitions
amaster bpm start <key> [options]   # Start process instance
amaster bpm tasks [options]         # List tasks
amaster bpm complete <id> [options] # Complete task
amaster bpm claim <id> [options]    # Claim task
amaster bpm instances               # List process instances
amaster bpm instance <id>           # Get instance details

Workflow

amaster workflow list               # List workflows
amaster workflow get <id>           # Get workflow details
amaster workflow execute <id> [options]
amaster workflow executions [options]
amaster workflow execution <id>

S3 Storage

amaster s3 list [options]           # List files
amaster s3 upload <file> [options]  # Upload file
amaster s3 download <key> [options] # Download file
amaster s3 delete <key> [options]   # Delete file
amaster s3 url <key> [options]      # Get file URL

OpenClaw Integration

amaster init [options]              # Initialize integration for an app
amaster doctor                      # Check integration status
amaster list                        # List installed skills and MCP servers
amaster switch <app-code> [options] # Switch to a different app
amaster uninstall [options]         # Remove integration for current app

Configuration

Configuration is stored in ~/.amaster/cli-config.json.

Environment Variables

• AMASTER_API_KEY - Your Amaster API key
• AMASTER_BASE_URL - Base URL for API (default: https://api.amaster.ai)

File Locations

• CLI Config: ~/.amaster/cli-config.json
• OpenClaw Config: ~/.openclaw/config.json
• Installed Skills: ~/.openclaw/skills/{appCode}/
• Amaster Config: ~/.amaster/openclaw-config.json

OSS Structure

The CLI expects skills and MCP configurations to be organized by app code in OSS:

/openclaw/
├── apps/
│   ├── {appCode1}/
│   │   ├── skills/
│   │   │   ├── manifest.json       # Skills manifest for this app
│   │   │   └── {skill-id}.zip      # Skill packages
│   │   └── mcp-config.yaml         # MCP server config for this app
│   └── {appCode2}/
│       ├── skills/
│       └── mcp-config.yaml

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Development mode
pnpm run dev

# Type check
pnpm run type-check

Architecture

The CLI integrates all Amaster SDK clients:

• @amaster.ai/client - Unified client for all services
• @amaster.ai/auth-client - Authentication
• @amaster.ai/entity-client - Entity CRUD
• @amaster.ai/bpm-client - BPM processes
• @amaster.ai/workflow-client - Workflow execution
• @amaster.ai/s3-client - File storage

License

MIT