CLI Installation
Install the CodeDD CLI, verify setup, and complete first-time authentication
Requirements#
- Python 3.10+ (3.10–3.13)
- CodeDD account with CLI token from Account → CLI Access
- At least one LLM API key (Anthropic, OpenAI, Gemini, or Grok)
System requirements#
File auditing runs on your machine. Peak RAM depends on concurrency, not total file count.
| Profile | RAM (free) | CPU | Notes |
|---|---|---|---|
| Minimum | 4 GB | 2 cores | Concurrency 1–4; small repos |
| Recommended | 8 GB | 4 cores | Concurrency 8–16; typical M&A repos |
| Large repos | 16 GB+ | 8+ cores | Concurrency 24–75; monorepos 5k+ files |
Disk: space for Git checkouts in scope plus ~/.codedd checkpoints (usually under 100 MB).
Network: stable HTTPS to your LLM provider and api.codedd.ai.
Install#
pip install codedd-cliFrom source:
git clone https://gitlab.com/codedd1/codedd-cli
cd codedd-cli
pip install -e .Verify and log in#
codedd --version
codedd auth login --token <your_cli_token>
codedd auth statusFor CI, set CODEDD_API_TOKEN instead of keychain storage.
Next step#
CodeDD CLI Guide — scope selection, audit execution, and remediation.
For billing and account help: Common Questions.