@taskclan/cli

The Taskclan Cloud CLI — deploy and manage apps from your terminal. A thin, dependency-free client over the Cloud API, authorized by an sk_cloud_* key.

Install

npm i -g @taskclan/cli
# or run without installing:
npx @taskclan/cli ls

Requires Node 18+.

Log in

Mint a key in the console (Developers → API keys), then:

taskclan login --key sk_cloud_xxxxxxxx

The key is saved to ~/.taskclan/config.json (mode 600). You can also set TASKCLAN_API_KEY in the environment (handy for CI). Point at a different API host with --api https://cloud.taskclan.com or TASKCLAN_API_URL.

Commands

taskclan ls                         # your deployments + status + URL
taskclan info <site>                # details for one deployment
taskclan sites:create <name>        # create a new deployment
taskclan deploy <site>              # trigger a new build (alias: redeploy)
taskclan rollback <site> [id]       # roll back to a previous ready build
taskclan open <site>                # print the live URL

taskclan logs <site>                # build log of the latest deployment
taskclan logs <site> --runtime      # stream live runtime logs

taskclan env <site> ls              [--scope production]
taskclan env <site> set KEY=VALUE   [--secret] [--scope production]
taskclan env <site> rm KEY          [--scope production]

taskclan domains <site> ls
taskclan domains <site> add app.yourdomain.com
taskclan domains <site> rm app.yourdomain.com

<site> matches by name or id (a short id prefix works too).

CI example

TASKCLAN_API_KEY=sk_cloud_xxx npx @taskclan/cli deploy my-app