Install

Global install (recommended):

npm install -g @aidelly/cli

Per-project:

npm install --save-dev @aidelly/cli

Without installing:

npx @aidelly/cli <command>

Verify installation

aidelly --version

Configuration

Environment variables

The CLI reads the following environment variables:

Variable	Required	Description
`AIDELLY_API_KEY`	Yes	Your Aidelly API key
`AIDELLY_WORKSPACE_ID`	No	Default workspace UUID
`AIDELLY_BRAND_ID`	No	Default brand UUID
`AIDELLY_API_BASE`	No	API base URL (default: `https://app.aidelly.ai/api/public/v1`)

Set them in your shell profile:

# ~/.zshrc or ~/.bashrc
export AIDELLY_API_KEY=aidelly_live_xxx
export AIDELLY_WORKSPACE_ID=your-workspace-uuid
export AIDELLY_BRAND_ID=your-brand-uuid

aidelly auth login

This stores credentials in ~/.aidelly/config.json.

Verify credentials

aidelly auth whoami

Generating an API key

Go to Settings → API Keys in your Aidelly dashboard
Click New Key
Give it a name (e.g., cli-local)
Select scopes: posts:write, posts:read (add others as needed)
Copy the key — it's shown only once

API access requires an active paid plan.

Installation