Authentication
Manage user authentication, tokens, and credentials with login, logout, and whoami.
The BuildShare CLI provides straightforward authentication commands for both local interactive terminals and headless CI/CD systems.
buildshare login
Authenticates your machine with BuildShare. In an interactive shell, it prompts for your email address and password. Stored authentication credentials are saved securely in your platform-specific config directory (~/.config/buildshare/ on Linux/macOS, %APPDATA%\buildshare\ on Windows).
Usage
Prompt for email and password interactively:
buildshare loginFlags
| Flag | Description |
|---|---|
--token <token> | Provide a personal access token directly instead of interactive login prompt |
buildshare logout
Revokes the active session credentials and clears the local authentication token from your configuration directory.
Usage
buildshare logoutbuildshare whoami
Displays information about the currently authenticated user account and active workspace context.
Usage
buildshare whoamiExample Output
Authenticated as: Alex Johnson (alex@example.com)
Workspace: Mobile Team Alpha (ws_98234)
Role: Admin