Easel CLI
Install and use the Easel CLI to authenticate, link projects, inspect deployments, and stream request logs.
The Easel CLI (easel) lets you authenticate from the terminal, link a local directory or monorepo to project(s), deploy from your working tree, list and inspect deployments, and read request logs. It is published as @easel-sh/cli and is currently in alpha.
Note: This is a preview feature currently under active development. Deploy uploads local source (or
--prebuiltoutput) and builds on the platform. You can still deploy from Git or the dashboard.
Install
Install the CLI globally with npm, or run it with npx without a global install:
The package exposes both easel and cli binaries. Examples in this guide use easel.
Check the installed version:
Global options
These options apply to platform commands:
| Option | Description |
|---|---|
-t, --token token | API token (overrides EASEL_TOKEN and saved credentials) |
-W, --workspace slug_or_id | Workspace slug or ID |
-F, --format human_or_json | Output format (defaults to human in a TTY, json otherwise) |
--no-color | Disable ANSI colors |
Point the CLI at a different API host with EASEL_API_URL (defaults to https://app.easel.sh).