Skip to main content

Installation

Install​

Install the latest published CLI:

uv tool install --force wendell
wendell --version

Alternative installers:

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

The CLI includes Wendell's local compiler/runtime engine. It does not require an OpenAI, OpenRouter, Anthropic, or other LLM provider key to install, register, compile, or run tests. 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.