SECURITY SPECIFICATION · AUTH PROTOCOL

Connect the CLI to your account

Connect your terminal to your Microbix account, sync credits, and store the sign-in token in ~/.aether_auth.

METHOD 01 · 6-DIGIT PIN PAIRING

Step-by-Step PIN Verification

1. Log into your Aether OS account at aether.microbix.in.
2. Navigate to Settings ? Developer & CLI.
3. Click Generate 6-Digit PIN (generates a temporary code that expires after 15 minutes, e.g. 482 910).
4. In your terminal, run aether and select option [1] Enter 6-digit connect PIN.
Endpoint: POST https://auth.microbix.in/api/cli/verify { "code": "482910" }
METHOD 02 · BROWSER MAGIC LINK

Sign in through your browser

Run aether --login to open the device approval page in your browser.

Init Endpoint: POST https://auth.microbix.in/api/cli/auth-link/init
Poll Endpoint: GET https://auth.microbix.in/api/cli/auth-link/poll?session_id=... (3 min timeout)
METHOD 03 · CREDENTIALS VAULT

Local ~/.aether_auth File Storage

Once paired, the session token is stored on disk in the user's home directory. The CLI enforces POSIX file permission 0600 (read/write only by owner) to prevent unauthorized reads by other local processes.

# ~/.aether_auth (Permissions: 0600)

{

  "active_profile": "default",

  "profiles": {

    "default": {

      "user_id": 1042,

      "email": "nidhish@microbix.in",

      "token": "mbx_tok_9f821a4e2b0c1f4a9d7b",

      "tier": "ultra",

      "created_at": "2026-09-30T15:28:00Z"

    }

  }

}
ESC