Clipless Docs

CLI ​

clipless ships with @clipless/react — it needs your JSX to extract a workflow.

bash
export CLIPLESS_URL=https://…        # or --url; default http://localhost:3000
export CLIPLESS_API_KEY=fd_test_…    # or --key; a secret key

manifest ​

bash
bunx clipless manifest expense-claim.tsx            # print the manifest
bunx clipless manifest expense-claim.tsx -o m.json  # write it

Extraction is strict: a stage defined twice, a transition to a stage that does not exist, an <Action> outside every stage, a blocking enter action, or a field action that cannot run (on="enter" on a field, or inside a <FieldGroup>) is an error.

deploy ​

bash
bunx clipless deploy expense-claim.tsx
bunx clipless deploy expense-claim.tsx --draft      # without publishing
bunx clipless deploy expense-claim.tsx --dry-run    # show what would be sent

build ​

bash
bunx clipless build expense-claim.tsx --out dist/clipless

One bundle per role, <workflowId>.<role>.js with a .d.ts: the file with every other role's <Stage> and every <Action> removed, then bundled and tree-shaken. @clipless/react and your packages stay external. A reviewer's panel, an AI prompt, a webhook URL never reach a browser that does not need them. <Stage actor> must be a string literal for this to work.

sessions / session ​

bash
bunx clipless sessions expense_claim_v1                    # in flight, newest first
bunx clipless sessions expense_claim_v1 --status completed
bunx clipless sessions supplier_check_v1 --user acme --period 2026

bunx clipless session expense_claim_v1 Xk2…               # the ledger, event by event, and the state
bunx clipless session expense_claim_v1 Xk2… --reveal      # show pii and vault values

Read-only. pii and vault values are masked unless --reveal. Rounds are listed when a stage came round more than once.

secrets ​

bash
bunx clipless secrets                                   # names, and the signing secret's prefix
printf %s "$KEY" | bunx clipless secrets set ANTHROPIC_API_KEY
bunx clipless secrets delete ANTHROPIC_API_KEY
bunx clipless secrets signing-secret                    # create or rotate; printed once

Values come from stdin (or --value) so they stay out of your shell history.