Setup

Workspaces and repositories connected to Cyrus.

Workspaces

Slack

When Cyrus asks a question on a Linear issue, it also sends the question as a Slack direct message to the person who delegated the issue. They can answer in Slack or in Linear. Connect a Slack workspace here, then choose it on a Linear workspace above.

Repositories

No repositories yet. Add one to get started.

Repository	Workspace	Base branch	Routing labels	Status

Loading…

Add repository

Repository URL Linear workspace Routing labels (comma-separated — defaults to repo name) Base branch (blank = auto-detect)

Cloning uses the byldd-cyrus bot. If it fails with an access error, ask an org admin to grant the bot access to this repo, then retry.

Add Linear workspace

Before continuing, confirm these one-time steps for the new workspace:

Invited cyrus@byldd.com (as admin) into the target Linear workspace.
In Linear, switched to the target workspace (top-left workspace switcher).
(admin, one-time) Redirect URI /oauth/callback is registered in the Byldd Linear OAuth app.

You'll authorize on Linear, then land back here. The workspace's token is stored on the server — never shown in the browser.

Connect Slack workspace

At api.slack.com/apps, choose Create New App, then From a manifest. Pick the Slack workspace and paste the manifest.
Open Install App and install it to the workspace.
Paste the app's two values below and press Connect.
Back in the Slack app, open Event Subscriptions. If the Request URL is not marked Verified, press Retry, then save. Cyrus can only confirm the URL once it has the signing secret, so this comes after Connect.
On a Linear workspace's card on this page, set Questions on Slack to this Slack workspace.

Bot User OAuth Token (OAuth & Permissions page, starts with xoxb-) Signing Secret (Basic Information page, under App Credentials)

Both values are stored on the server and never shown in the browser. The Slack workspace is read from the token.