Installation

Prerequisites

Node.js 20+ (check with node --version)
An email you can check (for the OTP flow) — or a cko_ key already copied from the dashboard

Install

npm install -g slideless
slideless --version

Global install puts slideless on your PATH. If npm install -g is blocked by your environment, npx slideless ... works for any command.

Authenticate

OTP (recommended)
Paste an existing key

Two commands and you’re done. No dashboard visit, no key to paste. Works equally well for first-time signup and for returning users on a new machine.First time — create an account:

slideless auth signup-request --email you@example.com
# check your inbox for the 6-digit code, then:
slideless auth signup-complete --email you@example.com --code 123456

Returning user on a new machine:

slideless auth login-request --email you@example.com
slideless auth login-complete --email you@example.com --code 123456

Output (same shape for both flows):

✓ Signup complete    # or "Login complete"

  Organization:  My Organization
  Org ID:        4XYwOrZ8...
  Profile:       my-organization (now active)
  API key:       cko_xxxx...  (scopes: presentations:write, presentations:read)

The CLI saves a profile to ~/.config/slideless/config.json (mode 0600) and sets it active. See cli/auth for the full flag reference (logo, brand colors, --key-expires-in, …) and the complete error-code table.

If you already created a cko_ key in the dashboard:

Open app.slideless.ai → API Keys (URL pattern: /organizations/<orgId>/org/api-keys)
Click Create API key, name it (e.g. my-laptop), and select scopes presentations:write and presentations:read
Copy the cko_… value — it’s shown only once
Run:

slideless login
# paste the cko_ key when prompted (input is masked)

The CLI verifies the key against the backend and saves it as a profile:

✓ Logged in successfully

  Profile:      <derived-from-org-name> (active)
  Organization: Your workspace
  Key:          cko_xxxx...
  Scopes:       presentations:write, presentations:read

Verify

slideless verify

If this prints ✓ API key valid with the expected scopes, you’re done.

Upgrading

npm install -g slideless@latest

Profiles and credentials are preserved across upgrades — config lives in ~/.config/slideless/, independent of the installed binary.

Getting Started

Why Slideless

Concepts

CLI

Guides

Plugin Skills

Advanced: HTTP API

Prerequisites

Install

Authenticate

Verify

Upgrading

Getting Started

Why Slideless

Concepts

CLI

Guides

Plugin Skills

Advanced: HTTP API

​Prerequisites

​Install

​Authenticate

​Verify

​Upgrading

Prerequisites

Install

Authenticate

Verify

Upgrading