Document CLI token auto-refresh and MINTLIFY_SESSION_TOKEN

[mintlify]

Summary

The CLI now automatically refreshes expired access tokens in the background and stores credentials in the OS keychain instead of the config file. A new MINTLIFY_SESSION_TOKEN environment variable enables authentication in CI/CD and headless environments.

Changes

• Updated cli/preview.mdx to reflect keychain-based credential storage, auto-refresh behavior, and added a new section on authenticating with the MINTLIFY_SESSION_TOKEN environment variable
• Updated cli/commands.mdx to document keychain storage for mint login, add a cross-reference to the env var docs, and add an environment variables reference table

---

Note

Low Risk
Low risk documentation-only change describing new credential storage and authentication options; no runtime code paths are modified.

Overview
Updates CLI docs to reflect that mint login credentials are stored in the OS keychain and access tokens auto-refresh in the background.

Documents headless/CI authentication via MINTLIFY_SESSION_TOKEN (including keychain-first fallback behavior) in Preview locally, and adds an Environment variables reference section to the commands reference.

^{Reviewed by Cursor Bugbot for commit 3d7f766. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Apr 7, 2026, 4:58 PM