Colabor.ai CLI

Deploy and manage Temporal workflows from the command line.

Installation

npm install -g @colabor/cli

Quick Start

# Register an account (requires invite code)
colabor register

# Login
colabor login

# Create a namespace
colabor ns create my-namespace

# Set current namespace
colabor ns use my-namespace

# Deploy from current directory
colabor deploy

# List namespaces
colabor ns list

# Show namespace details
colabor ns show my-namespace

# Rollback to previous version
colabor rollback 1.0.0

# Stop a deployment
colabor stop 1.0.1

Commands

Authentication

| Command | Description | |---------|-------------| | colabor register | Create a new account (requires invite code) | | colabor login | Login to your account | | colabor logout | Logout | | colabor whoami | Show login status |

Namespaces

| Command | Description | |---------|-------------| | colabor ns list | List namespaces you have access to | | colabor ns create <name> | Create a new namespace | | colabor ns show <name> | Show namespace details | | colabor ns use <name> | Set current namespace | | colabor ns current | Show current namespace |

Deployment

| Command | Description | |---------|-------------| | colabor deploy | Deploy current directory to namespace | | colabor rollback <version> | Rollback to a previous version | | colabor stop <version> | Stop a deployment |

Workflow Structure

Your workflow project should have:

my-workflow/
├── temporal.config.json   # Required
├── package.json
├── dist/                  # Compiled code
│   ├── workflows/
│   │   └── index.js
│   └── activities/
│       └── index.js
└── src/                   # Source (not deployed)

temporal.config.json

{
  "name": "my-workflow",
  "version": "1.0.0",
  "description": "My Temporal workflow",
  "temporal": {
    "workerOptions": {
      "maxConcurrentActivityTaskExecutions": 100,
      "maxConcurrentWorkflowTaskExecutions": 100
    }
  },
  "resources": {
    "memory": "512m",
    "cpus": "0.5"
  },
  "env": {
    "MY_API_KEY": "secret"
  }
}

Configuration

Config is stored in ~/.config/colabor-cli/config.json:

| Key | Description | |-----|-------------| | apiUrl | Backend API URL (default: http://localhost:3001) | | token | Auth token (set after login) | | namespace | Current namespace |

Environment Variables

You can also configure the CLI via environment variables:

export COLABOR_API_URL=https://api.colabor.ai

License

MIT