---
name: onboarding-issues
description: "Choose where a new project's agents track work: Linear, Jira, or Introspection's own issues, and connect Linear when chosen. The second onboarding step."
metadata:
  min-cli-version: "0.73.0"
  next: "onboarding-collaboration"
---

# Onboarding: issue tracking

## Ask

One question with the question tool, header "Issues", whatever the check found. Three options, in this order, labelled exactly:

- **Linear:** "Agents create and update issues in your Linear workspace."
- **Jira:** "Agents create and update issues in your Jira projects."
- **Introspection:** "Agents track work in Introspection's own issues; nothing to connect."

## Connect

- **Linear:** `introspection_open` with `{kind: "integration", provider: "linear"}`, `wait: true`, reason "So your agents can work with Linear issues", on its own in a turn with nothing said before it (on a host without the tool, `introspection open --integrations linear --wait` when `introspection open --help` lists `linear`, else the dashboard's Organization settings, Integrations). Installing needs an organization admin; if the result is `failed` with a permission error, say who can do it and move on. After `connected`, say in one line that Linear is connected, and move on without a command to check it: the card answers `connected` only once Linear shows as installed. If the owner says Linear is already connected, say so and move on.
- **Jira:** thank them, and say in one line that Jira support is on its way and we'll let them know when it's ready. Connect nothing.
- **Introspection:** say in one line that agents will use Introspection's own issues. Connect nothing.
- **Later:** record nothing.

## Done when

The owner chose a tracker or said later. Keep the choice for the rest of the conversation. Go to `onboarding-collaboration`.