leanly-cli

The Leanly CLI lets you authenticate, manage applications, trigger deployments, and connect cloud provider accounts — from the terminal or in CI/CD pipelines.

Installation

npx leanly@latest --help

Or install globally:

npm install -g leanly

Commands

Authentication

leanly login       # Log in via SSO (opens browser)
leanly logout      # Log out and clear stored credentials
leanly whoami      # Show current user, tenant, and role

Applications

leanly init                  # Create and link a new Leanly application from the current repo
leanly link                  # Link the current repo to an existing Leanly application
leanly get link              # Show the linked application id and tenant
leanly list apps             # List all applications in the tenant
leanly list envs             # List environments for the linked application

init detects the GitHub remote, opens the Leanly console to complete setup, then links the repo automatically. Pass --remote <url> to specify a GitHub URL explicitly, or --no-open to print the setup URL instead of opening a browser.

get link reads .leanly/project.json and prints the linked application id and tenant. Pass --json for machine-readable output.

list envs reads the linked application from .leanly/project.json. Pass --root-id <id> to target a specific application without linking.

Deployment

leanly deploy ref <ref>      # Request a deployment for a git ref (branch, tag, or SHA)

Reads the linked application from .leanly/project.json and prompts for the target environment. Pass --id <envId> to skip the prompt.

Cloud provider integrations

leanly connect aws <roleArn>                    # Connect an AWS account via IAM Role ARN
leanly connect gcp <serviceAccountEmail>        # Connect a GCP project via service account email
leanly connect hetzner <name>                   # Connect a Hetzner project (prompts for API key)

Help

leanly --help
leanly <command> --help