User Guide

API Tokens

Create and manage API tokens for CLI authentication.

Overview

API Tokens allow you to authenticate the AssistMe CLI tool with your account. Each token is tied to a specific device or environment.

Creating a Token

  1. Navigate to Tokens in the web dashboard sidebar
  2. Click Create Token
  3. Enter a label to identify the token (e.g., "My MacBook", "Work PC")
  4. The token will be displayed once — copy it immediately using the copy button

Important: The plain token is only shown once at creation time. It is stored as a SHA-256 hash and cannot be retrieved later. If you lose it, you'll need to create a new token.

Using a Token

After creating a token, authenticate the CLI by running:

assistme login

When prompted, paste your token to complete authentication.

Managing Tokens

The token list shows all your active tokens with:

  • Label — The name you gave the token
  • Created — When the token was created
  • Last Used — When the token was last used for authentication

Revoking Tokens

Click Revoke on any token to immediately invalidate it. Revoked tokens can no longer be used for CLI authentication. This is useful when:

  • A device is lost or compromised
  • You want to rotate tokens for security
  • You no longer use a specific device

Next Steps