Synopsis

homeboy auth <COMMAND>

Description

Authenticate with a project’s API and store credentials in the OS keychain.

Authentication is scoped per project ID.

Subcommands

login

homeboy auth login --project <project_id> [--identifier <username_or_email>] [--password <password>]

If --identifier or --password are omitted, Homeboy prompts on stderr and reads from stdin.

logout

homeboy auth logout --project <project_id>

status

homeboy auth status --project <project_id>

Output

JSON output is wrapped in the global envelope.

data is one of:

• { "command": "login", "project_id": "...", "success": true }
• { "command": "logout", "project_id": "..." }
• { "command": "status", "project_id": "...", "authenticated": true }

Note: command is a tagged enum value (login|logout|status), and fields use snake_case (project_id).

Related

• api
• project
• JSON output contract