Skip to main content

Synopsis

Description

auth commands connect directly to the database (no server required) for administrative user management. Use them to manage accounts, generate invite codes for new users, and control registration mode.
These commands write directly to the database. The profClaw server does not need to be running, but you must be in the same directory as the profClaw installation (or have the correct database path configured).

Subcommands

auth invite

Generate invite codes for new users to use during registration.
string
default:"1"
Number of codes to generate (max 50).
string
Expiration duration. Format: 7d, 24h, 30m. Codes without an expiry never expire.
string
Human-readable label for tracking (e.g., "For Alice", "Team onboarding").

auth reset-password <email>

Generates a random temporary password, invalidates all existing sessions for the user, and prints new recovery codes. The user must change their password after the next login.

auth list-users

string
Filter by user status. One of active or suspended.
boolean
Output as JSON.

auth list-invites

boolean
Show only codes that have not been used yet.
boolean
Output as JSON.

auth set-mode <mode>

string
required
Registration mode. open allows anyone to register. invite requires a valid invite code.

Examples