Skip to main content

Command

Description

Authenticates your CLI with the sb0 platform. Required before you can push agents or query deployed agents.

Usage

This will open your browser to complete authentication, or provide a link if the browser doesn’t open automatically.

Expected Flow

When to Login

You need to login:
  • Before first push - To deploy agents to the platform
  • Before querying - To access your deployed agents
  • After logout - If you previously logged out
  • New machine - When setting up on a new computer
You do NOT need to login for:
  • Local development - Using sb0 init, sb0 run, sb0 build
  • Reading documentation - Accessing public resources

Credentials Storage

Authentication credentials are stored locally in:
These credentials are used automatically for sb0 push and sb0 query commands.
Keep your credentials secure. Don’t share them or commit them to version control.

Session Duration

Sessions remain active until you explicitly logout or the token expires.

Logout

To logout and remove stored credentials:

Common Issues

Browser Doesn’t Open

If the browser doesn’t open automatically, copy the URL from the terminal and paste it into your browser manually.

Authentication Fails

Possible solutions:
  • Check your network connection
  • Ensure you’re using the latest version of the CLI
  • Try logging out and logging in again

Permission Denied

Solution: Ensure you have write permissions to ~/.sb0/ directory:

Next Steps

After logging in:
  1. Build your agent:
  2. Push to platform:
  3. Query your agent: