Skip to main content
BRICKS Project Desktop connects to your BRICKS workspace for project management, deployment, and pulling app files. You can log in with a one-time passcode or a workspace token.

​
Log in with a passcode

1

Open the control panel

Click the link on the login screen to open the BRICKS Controller token management page in your browser.
2

Generate a passcode

In BRICKS Controller, open Manage API Tokens and generate a one-time passcode.
3

Enter the passcode

Paste the passcode into the login screen and click Login.

​
Log in with a token

If you have a workspace token, you can use it directly:
  1. On the login screen, expand Login with Token
  2. Paste your workspace token
  3. Click Login

​
Multi-profile support

You can configure multiple workspace profiles and switch between them. Each profile stores its own authentication token and workspace connection.

​
Add a profile

  1. Open Settings > Account
  2. Click Add profile
  3. Log in with the new workspace credentials

​
Switch profiles

  1. Open Settings > Account
  2. Click Switch next to the profile you want to use
Switching profiles applies globally — all open projects use the active profile.

​
Remove a profile

In Settings > Account, click Remove next to any profile that is not currently active.
Credentials are stored locally at ~/.bricks-cli/config.json.

​
Connection status

The settings panel shows a connection indicator next to each profile:
  • Green dot — connected and authenticated
  • Red dot — connection failed or token expired
If your connection fails, try logging out and logging back in to refresh your token.

​
Next steps

Set up a project

Open or create a BRICKS project.