Official2026-05-21
DeepSeek TUI Docs Add Nix and Auth Diagnostics
The official README and install docs now clarify `deepseek auth status`, credential precedence, `auth clear`, a documented Nix path, and how auto routing is billed against the model that actually ran.
What changed upstream
The newest official README and install docs now close several gaps that older setup posts still leave fuzzy:
- Credential-source diagnosis is now documented: the README now tells users to run
deepseek auth statusto see whether the active key is coming from saved config, keyring, orDEEPSEEK_API_KEY. - Credential cleanup is explicit: the same README now documents
deepseek auth clear --provider deepseekas the supported way to remove or rotate a saved key. - Credential precedence is clearer: upstream now says saved config keys take precedence over keyring and environment variables, which matters when a machine keeps using the wrong DeepSeek account.
- Nix is now a documented install path: the official install docs now include
nix run github:Hmbown/DeepSeek-TUIplus flake examples, so Nix and NixOS users no longer need to rely on an inferred community-only path. - Auto-mode billing is easier to explain correctly: the README now says the route that actually ran is what cost tracking is charged against, even though auto mode begins with a small Flash routing call.
Practical setup guidance
This is not just documentation polish. It changes what a technically trustworthy DeepSeek TUI setup guide should tell readers:
- Wrong-key debugging should start with a documented source check, not guesswork.
- Teams rotating credentials need an official cleanup command, not just shell-export advice.
- Nix users now have a first-party install surface worth indexing directly.
- Auto mode can be recommended more confidently when cost attribution is tied to the real routed model.