# chdr — Chonkie DeepResearch CLI
A CLI for running and managing deep research reports via the Chonkie Labs API.
## Commands
```
chdr research <query> # Run a research query (streams progress, shows report)
--role <role> # User role for personalization
--signal <signal> # Research preferences
--no-stream # Poll instead of streaming events
--json # Output raw JSON
chdr ls # List recent research (alias: list)
--limit <n> # Number of results (default: 10)
--json # Output raw JSON
chdr view <id> # View a research report (supports partial ID prefix)
--json # Output raw JSON
chdr open <id> # Open research in browser (supports partial ID prefix)
chdr delete <id> # Delete a research report (supports partial ID prefix)
chdr auth login # Authenticate with API key
chdr auth logout # Remove stored credentials
chdr auth status # Show current auth state
```
## Key details
- IDs support prefix matching — `chdr view 3a6b` works if the prefix is unambiguous
- Web URL for any research: `https://labs.chonkie.ai/research/{full-id}`
- Reports can be very large (20,000+ lines) — use `--json` and save to file when programmatic access is needed
- Research takes 2-10 minutes to complete
- Config stored at `~/Library/Application Support/chdr/credentials.json` (macOS)