TaskBridge for Todoist

TaskBridge for Todoist is an app for Jira Cloud. It adds Jira issues to your own Todoist and shows each task's status on the issue. When a task is done, it offers to move the issue to Done, and moves it only when you click. It also adds your open issues to Todoist in one go, and makes Jira issues from your Todoist tasks.

Getting started

1. A Jira admin installs TaskBridge for Todoist from the Atlassian Marketplace. It starts with a 30-day free trial.
2. Each person who uses it needs their own Todoist account.
3. The first time you use the app, select Connect Todoist and sign in to your Todoist. Your tasks stay in your own Todoist: nobody else on the Jira site sees them.

Questions? See Support.

What it does

Add to Todoist

Add to Todoist in the issue's ••• menu opens this form:

Add task creates the task in your Todoist, links it to the issue, remembers the project, and shows Open in Todoist. If adding fails, the form keeps what you typed and shows the message above it. A double click creates only one task.

The issue panel

A collapsible TaskBridge for Todoist panel on the right of the issue view lists your own tasks for that issue: name, project, due date, and Open or Done.

• If the Jira due date changed since the last sync, it says, for example, "Jira due date is now 14 Nov." with Update in Todoist. Nothing is offered when Todoist already has the Jira date.
• If the Jira due date was removed, it says "The Jira due date was removed." with Clear the due date in Todoist.
• Done tasks never show either message.
• Add another task opens the same form.
• Unlink, on each task, asks "Unlink this task from the issue?" and then stops showing the task on the issue. The task stays in Todoist. If it's open, this issue's link is taken out of its description, so it shows again under Import from Todoist (unless its description links to another issue on the site too) and can be linked to another issue. A done task isn't changed. To delete a task, delete it in Todoist: the panel drops it the next time it opens.
• With no tasks of yours on the issue, it says "You have no Todoist tasks for this issue." with Add to Todoist.

The panel syncs when someone opens the issue. Nothing syncs in the background.

Move to Done

When one of your tasks on the issue is done in Todoist and the issue isn't done in Jira, the panel says "Your Todoist task is done." with Move issue to Done (named after the status). If Jira offers more than one done status, such as Done and Won't do, you pick one under Move to and select Move issue. The issue moves only when you click, with your own Jira permissions: if you can't change the issue's status, the panel doesn't offer it. If Jira needs more details to close the issue, the panel says so, and you use the issue's status menu instead.

The page in the Apps menu

TaskBridge for Todoist in Jira's Apps menu opens a page with three tabs.

Add my issues to Todoist lists, in a table, up to 50 open issues assigned to you that have no task of yours yet, most recently updated first, all ticked. It looks at up to 500 of your most recently updated open issues. Pick one Project and one Priority, untick any you don't want (or use Select all and Clear all), and select Add tasks, beside the dropdowns (the button shows how many are ticked, for example Add 12 tasks). Each becomes a task like the ones Add to Todoist makes, linked to its issue, one at a time, with a progress bar and "Added 3 of 12" as it goes. Each row's Result shows Added, Not linked or Not added. An issue that can't be added shows why, and the run goes on. If Todoist stops responding, your Todoist connection expires or something unexpected goes wrong, the run stops and the issues not reached stay ticked.

Import from Todoist lists up to 200 open tasks in the Todoist project you pick, each in its own card, without the ones that already link to an issue on this site. A subtask is listed like any other task. Create Jira issue opens Jira's own Create issue window with the task's name, description and due date filled in. You pick the project and issue type and save. The app then adds the new issue's link to the end of the task's description and links the task to the issue, so it shows in the issue's Todoist panel. The task stays open in Todoist.

Jira's Create window shows only the fields of the project and issue type (or request type) you choose there, so a request type without a Due date field gives the issue no due date. Pressing Escape or clicking outside the window makes Jira shrink it to the side of the screen instead of closing it: finish or close it there. If you leave the page before then, the new issue isn't linked to the task.

Link to an existing issue, beside Create Jira issue, links a task to an issue that already exists, such as one made while you were away from the page. Type the issue key, like ABC-12, or paste the issue's link, and select Link. The app checks that you can see the issue, then adds its link to the end of the task's description and links the task to it, as above.

Remove my data says what the app keeps about you on this Jira site: which Todoist tasks you linked to which issues, and the project you last used. Its red Remove my data button asks "Remove your data from this app?" and then deletes all of it, on every issue. Your tasks stay in Todoist. To disconnect Todoist too, remove the app in Todoist under Settings → Integrations. This tab works even when the subscription has ended or Todoist isn't connected; a message above the tabs then says why the other two can't be used. While Add tasks, Create Jira issue or Link is still running on another tab, it asks you to wait for that to finish first.

Connecting

The first time you use a screen, it says "Connect your Todoist account to add Jira issues as tasks." with Connect Todoist. You sign in to your own Todoist. If the connection stops working later, it says "Your Todoist connection has expired. Reconnect to continue." with Reconnect Todoist.

Each person's tasks live in their own Todoist account. Nothing is shared between Jira users.

Who can use it

• Every Jira user on the site, in the Jira Software and Jira Service Management issue view, and on the app's page in Jira's Apps menu.
• People who can only view an issue can still add it to their own Todoist.
• Up to 50 tasks per person per issue.

Pricing

Paid, with Atlassian's standard 30-day trial. When the site's trial or subscription is no longer active, every screen says "Your subscription has ended. Ask your Jira admin to renew." and does nothing else, except that the page's Remove my data tab still works.

Not in this version

Background or real-time sync, moving issues or adding tasks automatically, completing Todoist tasks from Jira, Confluence, adding issues from a search or the backlog, the app creating Jira issues by itself, Jira Service Management portal customers, Todoist sections, a subtask's parent task in Jira, importing completed Todoist tasks. Background versions need Forge to let apps reach Todoist outside a person's own use of Jira, which it doesn't today.

For Jira admins

The app asks for these permissions:

• Outside Atlassian, it sends data only to Todoist: api.todoist.com and app.todoist.com.
• It keeps each person's links, last project and account record in Forge storage, which only the app can read. Each person can delete their own records on the Remove my data tab of the app's page. See PRIVACY.md.
• Because it talks to Todoist, it is not eligible for Atlassian's "Runs on Atlassian" badge.

Support: the support portal or support@launchmotionlabs.com