We've shipped the Kadoa CLI. If you've been using the dashboard or API to manage workflows, you can now do it all from the terminal.

The CLI wraps our Node SDK and gives you a fast, scriptable interface for creating workflows, running extractions, and fetching data. It's designed for developers who prefer working in the terminal and for CI/CD pipelines.

npm install -g @kadoa/cli

Authenticate once and you're ready to go:

kadoa login
kadoa create "Extract product names and prices" --url https://example.com/products
kadoa list

You can create workflows with a natural language prompt, run them, and fetch the extracted data:

# Run a workflow and fetch results as CSV
kadoa run <workflowId>
kadoa data <workflowId> --format csv > products.csv

The CLI auto-detects the best output format: tables when you're in an interactive terminal, JSON when piping to other tools.

# Pipe to jq for filtering
kadoa list --json | jq '.[].name'

# Force JSON output
kadoa get <workflowId> --json

Team management (v0.2)

You can now see who you're logged in as and which team you're operating under:

kadoa whoami
# Name:    John Doe
# Email:   john@acme.com
# Team:    Acme Corp (Admin)
# API Key: tk-abc****xyz1

If your account belongs to multiple teams, list and switch between them:

kadoa team list
kadoa team switch "Acme Corp"

The kadoa list status column now shows the computed workflow state (Complete, Running, Failed, Paused, etc.) instead of just the raw lifecycle state.

Shell completions

Shell completions are included for bash and zsh, with inline workflow name hints when you tab through IDs.

For CI/CD, set KADOA_API_KEY as an environment variable and the CLI runs non-interactively:

# GitHub Actions example
env:
  KADOA_API_KEY: ${{ secrets.KADOA_API_KEY }}
steps:
  - run: |
      kadoa run $WORKFLOW_ID --json
      kadoa data $WORKFLOW_ID --format csv > output.csv

CLI documentation ->