Authentication¶
kardbrd-agent requires authentication with both kardbrd (for board access) and your LLM provider (for AI execution).
kardbrd authentication¶
Get your bot token from the kardbrd board settings:
- Open your board → Settings → Bots
- Create a bot or copy the existing bot token
- Set the environment variable:
LLM provider authentication¶
Claude CLI (default executor)¶
Claude CLI requires an Anthropic API key:
- Get an API key from console.anthropic.com
- Set the environment variable:
- Verify authentication:
Subscription required
Claude CLI requires an active Anthropic API subscription. If the API key expires or is revoked, kardbrd-agent posts an error comment on the card with re-authentication instructions.
Goose (multi-provider executor)¶
Goose supports 20+ LLM providers. Set your provider and its API key:
Tip
Run goose configure to interactively set up your provider. Goose can also store keys in your system keychain.
Codex CLI¶
Codex requires an OpenAI API key:
Re-authentication¶
If your LLM provider credentials expire:
- kardbrd-agent checks authentication at startup and before each card session
- On auth failure, the agent posts an error comment on the card with specific re-auth instructions
- A reaction is added to the triggering comment
- The agent continues running and retries auth on the next card event
To re-authenticate without restarting:
| Executor | How to re-authenticate |
|---|---|
| Claude | Run claude auth login or update ANTHROPIC_API_KEY |
| Goose | Update the provider-specific API key, or run goose configure |
| Codex | Update OPENAI_API_KEY |