Clickraft CLI

The official command-line interface for Clickraft — generate images, manage assets, and author visual workflows from your terminal or AI coding agent.

Status: Pre-release. The CLI is under active development. Not yet stable.

Install

npm install -g @clickraft/cli

Requires Node.js 20 or later.

Quick start

clickraft login
clickraft generate create --prompt "a serene mountain landscape at dawn"
clickraft balance
clickraft brand-model list
clickraft models list
clickraft models list --category image --tier pro
clickraft template list
clickraft template get <template-id>
clickraft template find "coffee brand"

Brand Model references

Use --brand-model to attach trained brand models to a generation. The flag is repeatable (max 3) and accepts an optional pose:

# Single brand model, primary image
clickraft generate create --model-slug nano-banana-2 \
  --prompt "product on marble" \
  --brand-model a2438521-abcd-4000-8000-000000000001

# Two brand models with pose selection
clickraft generate create --model-slug nano-banana-2 \
  --prompt "lifestyle shot" \
  --brand-model a2438521-abcd-4000-8000-000000000001:front \
  --brand-model b3549632-bcde-4000-8000-000000000002:3/4-right

Note: --brand-model only works with reference-supporting models (nano-banana-2 recommended).

Workflows

Create, inspect, and mutate visual workflows from your terminal:

clickraft workflow create --name "Product Shoot Pipeline"
clickraft workflow list
clickraft workflow list --tags marketing,ecommerce
clickraft workflow get <workflow-id>

# Apply operations with auto-rev (fetches current canvas_rev, retries once on conflict)
clickraft workflow apply <workflow-id> --auto-rev --from-file ops.json

# Or inline a single operation
clickraft workflow apply <workflow-id> --auto-rev \
  --op '{"op":"add_node","node":{"id":"gen-1","type":"imageGeneration","config":{}}}'

The --auto-rev flag is recommended for agent use — it fetches the current canvas_rev before mutating and retries once if a conflict occurs.

See docs/workflows.md for the full operation reference and examples.

Full documentation: docs.clickraft.ai/cli (coming soon)

Connecting to staging

The staging API (https://staging.clickraft.ai/api/agents/v1) sits behind Cloudflare Access Zero Trust. To authenticate non-interactively, create a service token in the Cloudflare Zero Trust dashboard (Access → Service Auth → Service Tokens), then export both halves before invoking the CLI:

export CLOUDFLARE_ACCESS_CLIENT_ID="<client-id>.access"
export CLOUDFLARE_ACCESS_CLIENT_SECRET="<client-secret>"

clickraft tokens list --profile staging
clickraft balance --profile staging
clickraft brand-model list --profile staging
clickraft models list --profile staging

Both env vars must be set together — if only one is set the CLI exits with a configuration error. Production usage (the default) does not require these env vars.

Use with AI coding agents

The Clickraft CLI is designed to work with Claude Code, Cursor, Codex, and other AI coding agents. Install the skills package for your agent:

npx skills add clickraft/skills

Development

git clone https://github.com/clickraft/cli.git
cd cli
npm install
npm test

License

Proprietary — Copyright (c) 2026 Clickraft, all rights reserved. See LICENSE.