Overview
Before using the VibeHub CLI, you need to authenticate with your VibeHub account. Authentication uses OAuth through your browser for security.Signing In
Basic Login
- Opens your default browser
- Directs you to VibeHub’s login page
- After signing in, returns you to the terminal
- Stores your credentials locally
Login with Profile
If you use multiple accounts, specify a profile:How Authentication Works
When you runvibe login:
- The CLI opens your browser to VibeHub
- You sign in with Google (or your existing session)
- VibeHub generates an authentication token
- The token is securely stored on your machine
Credential Storage
Your credentials are stored in:| OS | Location |
|---|---|
| macOS | ~/.vibehub/credentials |
| Linux | ~/.vibehub/credentials |
| Windows | %USERPROFILE%\.vibehub\credentials |
Credentials are stored in plain text. Ensure your home directory has appropriate permissions.
Checking Your Status
Who Am I?
See which account you’re logged in as:Managing Profiles
Profiles let you manage multiple VibeHub accounts.List Profiles
Switch Profile
Login to a New Profile
Signing Out
Logout from Current Profile
Logout from Specific Profile
Token Expiration
Authentication tokens may expire after a period of inactivity. If you see authentication errors:Troubleshooting
Browser Doesn’t Open
If the browser doesn’t open automatically:- Copy the URL printed in the terminal
- Paste it into your browser manually
- Complete the sign-in process
Token Not Saved
If login succeeds but you’re prompted again:- Check write permissions on
~/.vibehub/ - Ensure the credentials file isn’t read-only
- Try logging out and in again
Wrong Account
If you logged into the wrong account:Multiple Google Accounts
If you have multiple Google accounts:- Before running
vibe login, sign out of other Google accounts in your browser - Or use an incognito window for the login
- Or use profiles to manage multiple accounts
Security Best Practices
Protect Your Credentials File
Protect Your Credentials File
Ensure
~/.vibehub/credentials is readable only by you:Don't Share Tokens
Don't Share Tokens
Logout on Shared Machines
Logout on Shared Machines
Revoke if Compromised
Revoke if Compromised
If you suspect your token was compromised, log out and generate a new one by logging in again.