Description
When API key configuration fails (wrong key format, expired key, wrong provider), the error messages don't clearly indicate:
- Which provider the key was tried against
- What format the key should be in
- How to verify the key independently
- Where to get a new key
Users report confusion when their OpenRouter key is tried against OpenAI, or vice versa.
Impact
Medium — First-time setup friction. Users waste time debugging auth issues.
Suggested Fix
- Include provider name in all auth error messages
- Add a
ironclaw doctor auth subcommand that validates each configured key
- Show expected key prefix (e.g., 'OpenAI keys start with sk-...')
- Link to provider-specific setup docs in error messages
Description
When API key configuration fails (wrong key format, expired key, wrong provider), the error messages don't clearly indicate:
Users report confusion when their OpenRouter key is tried against OpenAI, or vice versa.
Impact
Medium — First-time setup friction. Users waste time debugging auth issues.
Suggested Fix
ironclaw doctor authsubcommand that validates each configured key