Skip to content

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

@chrisgwynne

Description

@chrisgwynne

Summary

The auth docs for mmx-cli say credentials are persisted to ~/.mmx/credentials.json, but in a real Linux setup the CLI can be authenticated and fully functional while that file does not exist.

This makes troubleshooting misleading, because users and agents will look for ~/.mmx/credentials.json, conclude auth is missing, and waste time debugging the wrong thing.

What I observed

Environment:

  • Linux
  • mmx installed with user npm prefix (npm_config_prefix=/home/chris/.npm-global)
  • CLI version: mmx 1.0.7

Observed behavior:

  1. ~/.mmx/credentials.json does not exist
  2. mmx quota show --non-interactive --quiet --output json still succeeds
  3. image generation also succeeds

So the CLI is definitely authenticated, just not via the location documented in the skill/docs snippet.

Reproduction

  1. Install mmx-cli
  2. Run mmx auth login --api-key ...
  3. Check for ~/.mmx/credentials.json
  4. Run mmx quota show --non-interactive --quiet --output json

Actual result

  • No ~/.mmx/credentials.json
  • Quota command succeeds, proving valid auth is present somewhere else

Expected result

One of these should be true:

  • auth is actually persisted to ~/.mmx/credentials.json, or
  • docs are updated to explain the real credential storage path/mechanism, or
  • the CLI exposes a command to show active config/auth source

Why this matters

This is especially confusing in agent/CI environments, where docs imply a simple file existence check is a valid auth diagnostic. Right now that check is false-negative.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions