The Setup tab is shown to executives (organization admins, or a role with the
ai-roi:executive permission). Connecting integrations needs permission to manage integrations in Settings → Integrations.Before you start
- AI ROI is turned on for your organization. It is in preview; contact your nOps account team.
- You can open Settings → Integrations in nOps.
- You know which GitHub organizations, GitLab groups or Bitbucket workspaces hold your company’s code.
The checklist
The Setup tab lists six steps. Until both required steps have data arriving, Setup is the only tab you see: the scores would mean nothing yet. After that, Setup moves to the last tab and shows a badge such as 4/6. Each step shows one of four states:1. Connect an AI coding tool (required)
Unlocks: AI spend per person. Connect at least one of:- Cursor
- Claude Enterprise (Claude Code spend counts; chat use does not)
- GitHub Copilot, which needs no separate connection: its spend comes in through the GitHub integration, matched by GitHub login.
2. Connect your code host (required)
Unlocks: merged PRs, AI cost per PR, time to merge. Connect one or more of:- GitHub
- GitLab (gitlab.com)
- Bitbucket Cloud
Self-hosted servers (GitHub Enterprise Server, GitLab self-managed, Bitbucket Data Center) and Azure DevOps are not supported yet.
3. Match people to their code host accounts
Unlocks: each person’s PRs and their AI cost per PR. nOps matches each person who has AI spend to their code host login, mostly from the email on their commits. The step reads, for example, “18 of 20 people with AI spend are matched to their pull requests”. It is done at 80% or more. If people are missing, the usual cause is that they commit with a personal or no-reply email. Either:- Ask them to commit with their work email (on GitHub, or make the work email their public profile email), or
- Link their login by hand in Manage teams. See Link a login to a person.
4. Group people into teams
Unlocks: the Engineering Overview, team scores, team comparisons and the team focus on the Executive Summary. Create your engineering teams in Manage teams. Until you do, AI ROI uses the groups from your AI seat tracking project’s Wallets, if you have one. See Teams and people.5. Connect Linear or Jira
Unlocks: a work type for PRs whose title or branch doesn’t name one. A PR that names a ticket in its branch (likeENG-123) takes its work type from that ticket’s type and labels, and its project from the Linear project or Jira epic. nOps reads only ticket types, labels, parents and project names, never ticket titles or descriptions.
Connect Linear or Jira in Settings → Integrations → Notifications. See Issue creation from recommendations; the same connection serves both.
6. Install the AI ROI Agent
Unlocks: exact AI cost per PR, and a work type for AI spend that never reached a merged PR. Each developer runs one command and signs in with their nOps login:How long until data shows
Cost per PR only counts days whose spend is final. Until then, recent PRs show Arriving. See Settled spend.