clevercloud/clever-tools

Clever Tools

Clever Tools is the official CLI for Clever Cloud, a Platform-as-a-Service (PaaS) provider. It allows you to deploy applications, manage add-ons (databases, storage, etc.), configure environment variables, domains, and monitor your services.

Use this skill when the user wants to deploy code to Clever Cloud, manage their hosted applications, or interact with Clever Cloud services.

Quick Start

# Login to Clever Cloud (opens browser for OAuth)
clever login

# For CI/CD, use token-based authentication
export CLEVER_TOKEN="your-token"
export CLEVER_SECRET="your-secret"

# Link an existing application to current directory
clever link <app-id>

# Or create a new application
clever create --type node myapp

# Deploy current directory
clever deploy

Essential Commands

Deployment

# Deploy current directory (git push to Clever Cloud)
clever deploy

# Deploy with specific commit or branch
clever deploy --branch main
clever deploy --commit HEAD~2

# Restart application
clever restart

# Stop application (scales to 0)
clever stop

# Check deployment status
clever status

# View deployment history
clever activity
clever activity --follow  # Live updates

Logs

# Stream live logs
clever logs

# View logs from last hour
clever logs --since 1h

# View logs before a specific time
clever logs --before 2024-01-15T10:00:00

# Filter by deployment
clever logs --deployment-id <id>

# Access logs (HTTP requests)
clever accesslogs
clever accesslogs --since 1h

Environment Variables

# List all environment variables
clever env

# Set a variable
clever env set MY_VAR "my value"

# Set multiple variables
clever env set VAR1=value1 VAR2=value2

# Remove a variable
clever env rm MY_VAR

# Import from .env file
clever env import .env

# Export for shell
clever env --format shell > .env

Domains

# List domains
clever domain

# Add a custom domain
clever domain add myapp.example.com

# Remove a domain
clever domain rm myapp.example.com

# Favorite domain (used in logs, URLs)
clever domain favorite set myapp.example.com

Add-ons (Databases, Storage, etc.)

# List your add-ons
clever addon

# List available add-on providers
clever addon providers

# Create a PostgreSQL database
clever addon create postgresql-addon mydb --plan dev

# Create Redis
clever addon create redis-addon myredis --plan s_mono

# Create S3-compatible storage (Cellar)
clever addon create cellar-addon mybucket

# Delete an add-on
clever addon delete <addon-id>

# Get add-on environment variables
clever addon env <addon-id>

Services (Managed services like Keycloak, Matomo)

# Link add-on to application
clever service link-addon <addon-id>

# Unlink add-on
clever service unlink-addon <addon-id>

Scaling

# View current scaling
clever scale

# Set instance size (flavor)
clever scale --flavor M

# Set number of instances
clever scale --instances 2

# Autoscaling
clever scale --min-instances 1 --max-instances 4

SSH Access

# SSH into running instance
clever ssh

# Run a command
clever ssh --command "ls -la"

Applications Management

# List all applications in organization
clever applications list

# List linked applications in current directory
clever applications

# Create new application
clever create --type <type> <name>
# Types: node, python, ruby, php, java, go, rust, docker, static...

# Delete application
clever delete

Common Global Options

These options work with most commands:

--app <app-id|name>      # Target specific app (when multiple linked)
--alias <alias>          # Use app alias (from clever link --alias)
--org <org-id|name>      # Target specific organization
-F, --format <format>    # Output format: human, json, json-stream, shell
-y, --yes                # Skip confirmation prompts

JSON output is useful for scripting:

clever env --format json | jq '.MY_VAR'
clever applications list --format json

Full Reference

For complete documentation of all commands, options, available runtimes, add-on providers, and deployment zones, see references/full-documentation.md.