Copilot AI Metrics for Jira Cloud

How Copilot AI Metrics works

This page explains how to install, access, configure, and use Copilot AI Metrics inside Jira Cloud. It covers every tab, the GitHub connection setup, and answers common questions about credentials and data privacy.

Install from Marketplace View product page

Platform

Jira Cloud

Demo mode

On by default

GitHub required

For live data

Data egress

GitHub API only

Demo mode is on by default

When you install the app, it opens in demo mode with a fully populated dashboard. You can explore every feature, chart, and view with sample data before entering any credentials. Demo mode can be toggled off at any time in the Settings tab once you are ready to connect your GitHub organization.

Getting started

Install from the Atlassian Marketplace

Go to the Atlassian Marketplace and search for "Copilot AI Metrics" or click the Install button above. You must be a Jira Cloud administrator to install apps. Installation takes about 30 seconds with no external configuration required.

Open the app — demo mode starts automatically

After installation, navigate to Apps → Copilot AI Metrics in the top Jira navigation bar. The app opens in demo mode by default, showing a complete populated dashboard so you can explore every feature immediately without any credentials.

Connect your GitHub organization (to go live)

To see your real GitHub Copilot data, open the Settings tab inside the app. Enter your GitHub organization name and a GitHub Personal Access Token (PAT) with the read:org and manage_billing:copilot scopes. Click "Test connection" to verify, then save. The dashboard switches from demo to live data automatically.

Explore your Copilot adoption data

Navigate between tabs using the top tab bar. Start with the Overview dashboard for a KPI summary, then move to Teams for contributor-level insights, Trends for historical charts, and AI Metrics for Jira delivery context.

Add the dashboard gadget (optional)

You can also add a Copilot AI Metrics gadget directly to any Jira dashboard. Open a dashboard, click "Add gadget", search for "Copilot AI Metrics", and add it. The gadget displays the same KPI overview in a compact dashboard tile.

Accessing the app

Copilot AI Metrics is available as a Jira Global Page and as a Dashboard Gadget.

Global Page (full-screen view)

Click Apps in the top Jira navigation bar.
Select Copilot AI Metrics from the list.
The app opens as a full-page view with tabs across the top.

Dashboard Gadget (compact view)

Open any Jira dashboard and click Add gadget.
Search for Copilot AI Metrics and add it.
The gadget displays the KPI overview in a compact dashboard tile.

App tabs

The app is organized into six tabs. Use the top tab bar to navigate between them.

1Start Here

The onboarding tab shown to first-time users. Explains demo mode, links to the setup wizard, and highlights key features. Helps new users understand what the app does before connecting their GitHub data.

2Overview

The primary dashboard. Displays KPI cards for active contributors, total seats, total suggestions, accepted suggestions, acceptance rate, lines accepted, chat users, and agent users — each with period-over-period deltas. Includes an adoption funnel visualization (Licensed → Ever Active → Active 30d → Active 7d → Active Today) and daily activity trend mini-charts. Export menu allows downloading metrics or contributor data as CSV.

3Projects & People

Team and contributor-level insights. Shows per-team adoption summary tiles and a full contributor table sortable by user, team, last activity date, and days inactive. Each contributor shows a status badge: Active, Inactive, or Never Used. Includes contributor rankings and leaderboards.

4Trends

Multi-series line and area charts for daily metrics over 7, 14, 30, or 90 day windows. Selectable metrics include daily active users, acceptance rate, contributor engagement, and usage patterns. Each chart shows a period summary with percentage delta comparing the second half of the period to the first. Includes a full daily data table.

5AI Metrics

Optional Jira delivery context enrichment. Shows created vs resolved issue trends, completion rate trends, contributor work activity, and updated issue trends — scoped to a specific Jira project key and filtered by issue type. Provides practical next steps and smart coaching actions such as seat reclaim recommendations, contributor recognition signals, and completion rate alerts.

6Settings

Admin configuration tab. Toggle demo mode on or off, enter your GitHub organization name and Personal Access Token, test the connection, and save. Configure optional settings such as data provider selection, Jira project scope, issue type filters, refresh interval, and notification thresholds for completion rate, contributor activity, and low-activity days.

Setting up your GitHub Personal Access Token

A GitHub PAT is required to fetch live Copilot data. It is stored in Atlassian Forge's encrypted storage and is never sent to any external server. Follow these steps to create and add the token:

Go to GitHub.com → Settings → Developer settings → Personal access tokens → Tokens (classic).

Click "Generate new token (classic)".

Give the token a descriptive name such as "Copilot AI Metrics Jira".

Set the expiration to your preferred duration (90 days or longer recommended).

Select the required scopes: read:org and manage_billing:copilot.

Click "Generate token" and copy the token value.

In the Copilot AI Metrics Settings tab, paste the token and enter your GitHub organization name.

Click "Test connection" to verify the credentials, then save.

Technical specifications

Platform: Atlassian Forge (Jira Cloud only)
Runtime: Node.js 24 on ARM64
Permissions: Read-only Jira access + app storage
Credential storage: Forge encrypted Key-Value Store
External calls: GitHub API (api.github.com) only
Frontend: React 18 + TypeScript Custom UI
Access modes: Global Page + Dashboard Gadget
Export: CSV export for metrics and contributors

Common questions

Does the app require a GitHub Copilot subscription?

Yes. The app reads data from the GitHub Copilot Metrics API, which requires an active GitHub Copilot for Business or Enterprise subscription. Without a Copilot subscription, no seat or usage data is available. Demo mode works without any GitHub credentials.

What GitHub PAT scopes are required?

The token requires read:org (to read organization membership) and manage_billing:copilot (to read Copilot seat and usage data). No write permissions are needed.

Is the GitHub PAT stored securely?

Yes. The token is stored in Atlassian Forge's encrypted key-value store and is never transmitted to any external server. It is used only to make server-side API calls from the Forge runtime directly to the GitHub API.

What does demo mode show?

Demo mode populates the entire dashboard with realistic sample data so you can evaluate every feature before connecting your GitHub organization. It is enabled by default on first install and can be toggled off at any time in Settings.

Can I use the app without connecting GitHub?

Demo mode is always available and shows sample data. The AI Metrics tab (Jira delivery context) also works independently of GitHub and only requires selecting a Jira project key.

Do I need to be a Jira admin to install?

Yes, installing Forge apps on Jira Cloud requires Jira administrator permissions. Once installed, the app is accessible to all Jira users. The Settings tab configuration (GitHub credentials) requires admin access within the app.

Does the app send data to external servers?

No. The app runs entirely on Atlassian Forge infrastructure. The only external calls made are from the Forge runtime directly to the GitHub API (api.github.com) when fetching Copilot data. No data is sent to Baytek servers.

I need help. How do I contact support?

Email support@baytekdev.com. Support is available Monday to Friday, 9 AM to 5 PM Pacific Time.

Need help?

Our support team is available Monday through Friday, 9 AM to 5 PM Pacific Time.

Submit a support request support@baytekdev.com