Skip to main content

Installation

Install​

Install the latest published CLI with the hosted installer:

curl -fsSL https://www.wendellai.com/install | bash
wendell --version

Python package installers are also supported:

uv tool install --force wendell
pipx install --force wendell
python3 -m pip install --user --upgrade wendell

CLI source, packaging, and CLI-specific release automation live in the Wendell open source repository: https://github.com/WendellOfficial/wendell-cli.

For coding agents that support Vercel's Skills Registry, install the reusable Wendell skill:

npx skills add WendellOfficial/wendell-cli --skill wendell

The CLI does not require an OpenAI, OpenRouter, Anthropic, or other LLM provider key to install, register, create Playbook drafts, or run hosted suites. Wendell's hosted service generates suites from reviewed Playbooks. Your own agent_command may need provider credentials if your agent uses an LLM.

Register​

Register creates a runner session and stores a scoped credential locally.

wendell register

Non-interactive registration for automation:

printf "%s\n" "$WENDELL_PASSWORD" | wendell register \
  --email you@example.com \
  --agent "Refund Agent" \
  --provider openai \
  --model gpt-4.1 \
  --password-stdin

Login with an API key​

For CI or development environments with an existing API key:

printf "%s\n" "$WENDELL_INKPASS_API_KEY" | wendell login \
  --api-key-stdin \
  --validate

Credential storage​

By default credentials are stored at:

~/.config/wendell/credentials.json

Set WENDELL_CONFIG_HOME to use a different directory.

CI may use WENDELL_INKPASS_API_KEY. Environment credentials take precedence over stored credentials.

To copy the locally stored runner credential into a CI secret manager:

wendell auth export --format raw | gh secret set WENDELL_INKPASS_API_KEY

For CI jobs that only run published suites, use a runner key scoped to wendell:test-suites:read, wendell:runs:create, and wendell:runs:read. Only trusted authoring automation should receive wendell:test-suites:create, wendell:test-suites:update, or wendell:test-suites:publish.