contextd auth

Authenticate with the contextd remote service for team context sharing.

Usage

contextd auth <action>

Actions

login

Authenticate and save credentials to ~/.contextd/config.json.

contextd auth login

You’ll be prompted for:

1. Org slug — Your organization identifier (e.g., acme)
2. Key name — A label for this device/session (e.g., laptop)
3. Existing API key — Leave blank to create a new org, or provide an existing key to add a new key to an existing org

Creating a new org: Leave the API key blank. A new organization and API key will be created.

Adding a key to an existing org: Provide an existing API key. A new key will be added under your org name.

After authentication, your credentials are saved:

{
  "token": "ctxd_...",
  "org": "acme"
}

logout

Remove saved credentials:

contextd auth logout

This deletes ~/.contextd/config.json.

Environment variables

Next steps

After authenticating, you can:

• Subscribe to shared collections with sync add
• Publish your local contexts with sync publish