Skip to content

docs: fix misleading auth file references (#80)#86

Closed
raylanlin wants to merge 2 commits intoMiniMax-AI:mainfrom
raylanlin:main
Closed

docs: fix misleading auth file references (#80)#86
raylanlin wants to merge 2 commits intoMiniMax-AI:mainfrom
raylanlin:main

Conversation

@raylanlin
Copy link
Copy Markdown
Contributor

Summary

Fixes #80 — the docs previously implied that ~/.mmx/credentials.json is the only auth storage location, which misleads users who authenticate via API key instead.

Changes

  • SKILL.md: Clarified that API key auth persists to ~/.mmx/config.json, while OAuth persists to ~/.mmx/credentials.json.
  • docs/cli-design.md: Rewrote the auth section to explicitly state that credentials.json is not required when using API key auth, and documented the full credential resolution order.

Why this matters

Users and agents troubleshooting auth issues would look for credentials.json, conclude auth is missing, and debug the wrong thing. This change makes the docs accurate for all auth methods.

- SKILL.md: clarify that API key auth persists to config.json,
  OAuth persists to credentials.json
- docs/cli-design.md: rewrite auth section to explain that
  credentials.json is not required when using API key auth
Remove incorrect claim that $MINIMAX_API_KEY is part of the resolver
chain. The env var is checked by ensureApiKey() in main.ts before
command execution, and persisted to config.json — it is not directly
resolved by resolveCredential().
@raylanlin
Copy link
Copy Markdown
Contributor Author

Closing — superseded by #84 which covers the same auth doc fixes. Will submit a follow-up PR for docs/cli-design.md credential resolution docs after #84 merges.

@raylanlin raylanlin closed this Apr 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Auth docs mention ~/.mmx/credentials.json, but authenticated CLI works without that file

1 participant