Documentation

Getting started.

From invitation to an active bridge. Nothing is written to either system until you activate — and the wizard shows the exact import first.

Before you begin

TaskBridge is an invite-only beta. Sign-in is limited to an explicit allowlist of email addresses, so you need an invitation from the operator before the steps below will work. See Support for how to reach the operator.

You also need:

• A Linear account with issues assigned to you.
• A Todoist account with a project you want mirrors in.

Sign in

There are no passwords. Enter your email address at https://tasks.bvdm.ai and TaskBridge sends a sign-in link.

• The link works once and expires in 15 minutes.
• At most 3 links per hour are issued per address.
• A successful sign-in starts a session that lasts up to 30 days, stored in an HTTP-only cookie.

Connect both accounts

On the Connections page, connect Linear and Todoist through each provider’s own OAuth consent screen. TaskBridge never sees your provider passwords.

• Linear is authorized with the read,write scope, acting as you. Write access is used only to move issues between workflow states and to register the webhook that keeps your bridge current. When you connect, TaskBridge registers a webhook for your workspace automatically — there is nothing to configure in Linear.
• Todoist is authorized with the data:read_write scope, used to create, update, complete, and reopen mirror tasks in your chosen project.

Access tokens are stored only as AES-256-GCM ciphertext. Disconnecting a provider deletes the stored ciphertext immediately. Details in Security & OAuth.

Create a bridge

A bridge joins your Linear connection to one Todoist project. The wizard walks through four decisions; each step saves when you press Continue, and the preview always reflects what has been saved.

1. Source. Your Linear workspace, and a name for the bridge.
2. Scope. The Linear teams to include. Within them, open issues assigned to you are in scope.
3. Destination. The Todoist project where mirrors are created.
4. Workflow behavior. Per team, two questions: which state “done” moves an issue to, and where “not done” returns it. The step states each policy as the sentences TaskBridge will act on — see Completion semantics.

Preview & activate

The final step computes the import on the server and lists every issue that will be mirrored — for example, “18 issues will be imported · 12 from BAR, 6 from AGQ” — with each issue’s identifier, title, and current state. Activation imports precisely that list. Nothing is created, updated, or completed anywhere before you press Activate.

After activation

• New issues assigned to you appear as Todoist tasks, usually within seconds of the provider webhook.
• A per-bridge repair pass reconciles every 5 minutes by default, so a missed webhook delays a change — it never loses one.
• Sync now triggers a manual reconciliation, throttled to once per 60 seconds per bridge.
• The bridge page shows live, exact counts — linked tasks, pending, retrying, failed, blocked — and an activity ledger recording every run with its trigger, mode, and result.

Pause, export, delete

• Pause stops reconciliation for the bridge; Resume triggers a fresh sync.
• Export downloads the bridge configuration as JSON.
• Delete requires typing a confirmation, and the dialog leads with the consequences: Todoist tasks are left in place and never deleted; the bridge’s configuration and history are removed. Nothing is changed in Linear.