Skip to main content

Start tasks from Linear

Jaah joins your Linear workspace as an agent. Delegate an issue to Jaah, @mention Jaah in a comment, or add the start label, and Jaah starts a task in the Jaah project the issue's team is mapped to. Jaah reports on the issue as it works, and moves the issue to Done when the task is done.

Setting it up takes an Owner or Admin of your Jaah organization who is also an admin of the Linear workspace.

Connect Linear​

  1. In Jaah, open Settings > Integrations > Issue trackers and select Add tracker. Keep Linear as the Tracker. The page lists these steps beside the fields.
  2. Open Secret and choose Add new…. Select Connect Linear, sign in to Linear, and approve Jaah for your workspace. This installs Jaah in the workspace: people can now delegate issues to Jaah and mention it. You come back to Add tracker with the new secret picked.
  3. Select Next. The connection and an automation that files its tasks are made.
  4. On Projects, pick a Linear team and the Jaah project its issues start tasks in; Add another row for each team. Select Next.
  5. On Labels & people, change the Start label or Done state if you want, then select Finish.

If Connect Linear says Jaah's Linear app isn't set up, Jaah's operator has not registered it yet. A Linear secret holding a personal API key can't be connected as a tracker: Next asks for Connect Linear instead. Such a secret still lets agents act on issues.

Map more teams​

  1. Open Settings > Integrations > Issue trackers and select the Linear connection.
  2. On Mapping, select Add, pick a Linear team and the Jaah project its issues start tasks in. Repeat for each team.
  3. Optional: change the Start label (default jaah) or the Done state (default Done; a name no team has falls back to the team's first completed state).
  4. Select Save.

Project editors can link teams from their project instead: see Link a project to an issue tracker. Issues of a team with no mapping start nothing. Each event and what Jaah did with it is listed on the connection's Events tab.

Start a task​

In an issue of a mapped team, do one of these:

  • Delegate the issue to Jaah.
  • Mention @Jaah in a comment. The comment becomes the task's instruction.
  • Add the start label.

The task's body is the issue's title, description and earlier comments, with a link to the issue. One issue has one task at a time: starting it again while its task works does nothing.

The person who starts it must be a member of your Jaah organization with the same email, unless Non-members can start tasks is on (People tab).

Follow it on the issue​

Jaah answers in the issue's agent session (or with comments, for a task started by the label):

  • within seconds, Started work with a link to the task;
  • a line when work starts and when the task waits for an answer;
  • each question the task asks;
  • the pull request's link;
  • Done or Failed with the task's summary.

When the task is done, Jaah moves the issue to the done state. The same rules for every tracker, and for tasks linked by hand: What Jaah posts on the issue.

Answer and follow up​

Reply in the issue's Jaah thread, or comment on the issue. The reply answers the task's open question, and the task carries on. With no question open, it becomes a comment on the task.

Only members of your organization who may act on the task are heard. Anyone else gets one reply: "Not allowed to act on this task."

Stop the task​

Any of these stops it:

  • Select Stop on Jaah in the issue's thread.
  • Take Jaah off the issue as its delegate.
  • Remove the start label.

Starting the issue again later starts a new task.