pdd setup is the required first step after installing PDD. It detects available agentic CLI tools, discovers API keys, configures the model list, optionally creates a .pddrc, runs a live model test, and prints a summary. The wizard can be re-run at any time to add providers, update keys, or change settings.
Usage
pdd setup takes no arguments or flags. It is fully interactive.
The 6-step setup wizard
Detect agentic CLI tools
Scans
PATH for supported agentic CLI tools: Claude Code (claude), Gemini CLI (gemini), and Codex CLI (codex). Offers installation instructions and API key configuration if none are found.At least one of the following is required for agentic commands:| Tool | Install | API key |
|---|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code | ANTHROPIC_API_KEY |
| Gemini CLI | npm install -g @google/gemini-cli | GOOGLE_API_KEY or GEMINI_API_KEY |
| Codex CLI | npm install -g @openai/codex | OPENAI_API_KEY |
Scan for API keys
Searches for API keys across
.env, ~/.pdd/api-env.*, and the current shell environment. If no keys are found, prompts you to enter one.Configure models from llm_model.csv
Selects appropriate models from the bundled
data/llm_model.csv reference file based on your available API keys. The CSV contains top models (ELO ≥ 1400) across all LiteLLM-supported providers, with columns for provider, model identifier, cost, ELO rating, API key name, and reasoning capabilities.Create .pddrc (optional)
Offers to create a
.pddrc project configuration file. Recommended for multi-context projects such as monorepos.Test the first available model
Makes a real LLM call with the first available model to verify the API key and model configuration are working correctly.
After setup: source the API environment file
After the wizard completes, source the generated API environment file so your keys take effect in the current terminal session:- zsh
- bash
pdd setup.
Re-running setup
pdd setup can be re-run at any time to:
- Add a new provider or API key.
- Switch to a different agentic CLI tool.
- Update the model configuration after adding new keys.
- Regenerate or update
.pddrc.
Setup banner
If you skippdd setup after installation, the first time you run another pdd command, it will detect missing setup files and display a reminder banner. The banner is suppressed once ~/.pdd/api-env exists or when your project already provides credentials via .env or .pdd/.
pdd setup installs shell tab completion automatically. If you need to refresh the completion script without re-running the full setup wizard, run pdd install_completion directly.Related commands
pdd connect— Launch the web interface after completing setup.pdd auth— Authenticate with PDD Cloud separately from local API key setup.