Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

CTOR 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
You can also switch from the main chat input bar — click the workspace pill next to the sandbox-mode selector and pick a profile from the dropdown. 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.