Skip to main content

​
Synopsis

profclaw auth <subcommand> [flags]

​
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

SubcommandDescription
inviteGenerate one or more invite codes
reset-password <email>Reset a user’s password and generate new recovery codes
list-usersList all registered users
list-invitesList all invite codes and their status
set-mode <mode>Set registration mode to open or invite

​
auth invite

Generate invite codes for new users to use during registration.
​
-n, --count
string
default:"1"
Number of codes to generate (max 50).
​
--expires
string
Expiration duration. Format: 7d, 24h, 30m. Codes without an expiry never expire.
​
--label
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

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

​
auth list-invites

​
--unused
boolean
Show only codes that have not been used yet.
​
--json
boolean
Output as JSON.

​
auth set-mode <mode>

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

​
Examples

profclaw auth invite