fix(auth): document MMX_CONFIG_DIR in credential errors

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: kartikkabadi

ERRORS.md

@@ -15,6 +15,7 @@ This document lists all error scenarios and the messages users will see.
 | OAuth error in callback | `OAuth error: ${error}` |
 | OAuth token exchange failed | `OAuth token exchange failed: ${body}` |
 | `MINIMAX_API_KEY` already set (non-interactive) | `Warning: MINIMAX_API_KEY is already set in environment.` |
+| No credentials found (non-interactive) | `No credentials found.` + hint: `Log in: mmx auth login`, `--api-key sk-xxxxx`, `MINIMAX_API_KEY=sk-xxxxx`, or `MMX_CONFIG_DIR=/path/to/.mmx` |
 
 ### `mmx auth logout`
 

README.md

@@ -158,6 +158,18 @@ Useful for CI/CD (`mmx auth login --api-key sk-xxxxx`), or pass per-command via
 OAuth and API key are mutually exclusive — logging in with one clears the other.
 Credential priority: `--api-key` flag > OAuth (config) > `api_key` (config).
 
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `MINIMAX_API_KEY` | API key (alternative to `--api-key` / login). |
+| `MINIMAX_REGION` | `global` or `cn`. |
+| `MINIMAX_BASE_URL` | Override the API base URL. |
+| `MINIMAX_OUTPUT` | `text` or `json`. |
+| `MINIMAX_TIMEOUT` | Request timeout in seconds. |
+| `MINIMAX_VERBOSE` | `1` to enable verbose HTTP logging. |
+| `MMX_CONFIG_DIR` | Directory containing the `config.json` file (default: `~/.mmx`). Set this when `mmx` runs from a subprocess, service, or CI job whose home directory differs from where you logged in. |
+
 ### `mmx config` · `mmx quota`
 
 ```bash

src/auth/resolver.ts

@@ -26,6 +26,9 @@ export async function resolveCredential(config: Config): Promise<ResolvedCredent
   throw new CLIError(
     'No credentials found.',
     ExitCode.AUTH,
-    'Log in:        mmx auth login\nPass directly:  --api-key sk-xxxxx',
+    'Log in:             mmx auth login\n' +
+      'Pass per-call:      --api-key sk-xxxxx\n' +
+      'Or set env vars:    MINIMAX_API_KEY=sk-xxxxx\n' +
+      '                    MMX_CONFIG_DIR=/path/to/.mmx',
   );
 }

src/auth/setup.ts

@@ -46,7 +46,10 @@ export async function ensureAuth(config: Config): Promise<void> {
     throw new CLIError(
       'No credentials found.',
       ExitCode.AUTH,
-      'Log in:        mmx auth login\nPass directly:  --api-key sk-xxxxx',
+      'Log in:             mmx auth login\n' +
+        'Pass per-call:      --api-key sk-xxxxx\n' +
+        'Or set env vars:    MINIMAX_API_KEY=sk-xxxxx\n' +
+        '                    MMX_CONFIG_DIR=/path/to/.mmx',
     );
   }
 

test/auth/resolver.test.ts

@@ -1,5 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
 import { resolveCredential } from '../../src/auth/resolver';
+import { CLIError } from '../../src/errors/base';
 import type { Config } from '../../src/config/schema';
 import { mkdirSync, rmSync } from 'fs';
 import { join } from 'path';
@@ -59,6 +60,21 @@ describe('resolveCredential', () => {
     await expect(resolveCredential(config)).rejects.toThrow('No credentials found');
   });
 
+  it('no-credentials hint mentions MMX_CONFIG_DIR and all remediation options', async () => {
+    const config = makeConfig();
+    try {
+      await resolveCredential(config);
+      throw new Error('expected resolveCredential to throw');
+    } catch (err) {
+      expect(err).toBeInstanceOf(CLIError);
+      const hint = (err as CLIError).hint ?? '';
+      expect(hint).toContain('mmx auth login');
+      expect(hint).toContain('--api-key');
+      expect(hint).toContain('MINIMAX_API_KEY');
+      expect(hint).toContain('MMX_CONFIG_DIR');
+    }
+  });
+
   it('prefers flag over file api key', async () => {
     const config = makeConfig({ apiKey: 'sk-flag', fileApiKey: 'sk-file' });
     const cred = await resolveCredential(config);