Factory Console

Factory Console is a small Brave and Chrome extension for SuperPlane factory lines.

It starts draft tasks from the browser toolbar. It also checks for tasks that move to Review.

When a task needs review, the extension can:

• Show a desktop notification.
• Add the review count to the toolbar icon.
• Play a short chime.
• Read the task name aloud.
• Open the pull request from the task status note.

How it connects

The extension uses your current app.superplane.com browser session. It does not store an API token or password.

Factory Console requests access only to https://app.superplane.com/*. Task data stays in local browser storage.

Install a release in Brave

1. Open the latest Factory Console release.
2. Download the factory-console-v*.zip file from Assets.
3. Extract the ZIP file to a permanent directory.
4. Open brave://extensions in Brave.
5. Turn on Developer mode.
6. Select Load unpacked.
7. Select the extracted Factory Console directory.
8. Pin Factory Console for SuperPlane to the browser toolbar.

Use chrome://extensions for the same process in Google Chrome.

Build from source

Use these steps only when you want to change or test the source code.

1. Install the project dependencies:

   npm install

2. Build the extension:

   npm run build

3. Open brave://extensions in Brave.

4. Turn on Developer mode.

5. Select Load unpacked.

6. Select the dist directory from this repository.

7. Pin Factory Console for SuperPlane to the browser toolbar.

Connect a SuperPlane line

1. Sign in to SuperPlane.
2. Open the line that you want to control.
3. Select the Factory Console toolbar icon.
4. Select Use current board.

The console resolves the workspace and line from the active page. It checks SuperPlane every 30 seconds.

Start and review tasks

• Select Start beside a Backlog task to dispatch it to the connected line.
• Select Open task to inspect a running task.
• Select the review action to open the pull request or SuperPlane task.

Factory Console alerts once when a task enters Review. It can alert again if the task leaves and later returns.

Alert settings

Open Alert settings in the extension popup to control:

• Background checks: Check SuperPlane every 30 seconds.
• Voice alerts: Play a chime and read the task name aloud.
• Desktop notifications: Show a notification for a new review task.
• Play test alert: Verify the selected alert options.

Development

Run all checks:

npm run check

Run an individual step:

npm test
npm run build
npm run format:check

The build command creates dist and validates every file referenced by the extension manifest.

Create the tested release ZIP:

npm run package:release

The command writes the install-ready archive to release/.

Browser permissions

Permission	Purpose
activeTab	Read the current SuperPlane board URL after you select the extension.
alarms	Check the connected line every 30 seconds.
notifications	Show desktop review alerts.
offscreen	Play the review chime in the background.
storage	Save the connected line, settings, and alert history locally.
tts	Read review alerts through the system voice.

The monitor does not wake a sleeping device. It checks SuperPlane after the browser resumes.