Jenkins Job Insight

AI-powered Jenkins failure analysis -- classifies test failures as code issues or product bugs.

Documentation -- configuration, API reference, integrations, and more.

Prerequisites

An AI provider CLI must be installed and authenticated: Claude, Gemini, or Cursor. See docs for setup details.

Quick Start

mkdir -p data
docker run -d -p 8000:8000 -v ./data:/data \
  -e JENKINS_URL=https://jenkins.example.com \
  -e JENKINS_USER=your-username \
  -e JENKINS_PASSWORD=your-api-token \
  -e AI_PROVIDER=claude \
  -e AI_MODEL=your-model-name \
  ghcr.io/myk-org/jenkins-job-insight:latest

Features

• AI-Powered Failure Analysis — Classifies test failures as code issues or product bugs
• AI Token Usage Tracking — Track token consumption, costs, and duration for all AI CLI calls. Admin dashboard shows usage by provider/model/time period with CSV export.

CLI

uv tool install jenkins-job-insight
export JJI_SERVER=http://localhost:8000

jji health
jji analyze --job-name my-job --build-number 42
jji results list
jji admin token-usage              # Summary dashboard
jji admin token-usage --group-by model  # Grouped breakdown
jji admin token-usage --job-id <uuid>   # Per-job usage
jji admin token-usage --period month --format csv  # CSV export

Run jji --help for all commands.

API

Endpoint	Description
GET /api/admin/token-usage	Aggregated token usage with filters and grouping (admin only)
GET /api/admin/token-usage/summary	Dashboard summary: today/week/month stats (admin only)
GET /api/admin/token-usage/{job_id}	Per-job token usage breakdown (admin only)

See the API reference for all endpoints.

Web Push Notifications

Users can receive browser push notifications when @mentioned in comments. The server uses VAPID for Web Push authentication.

Variable	Description
VAPID_PUBLIC_KEY	VAPID public key (auto-generated with private key if not set)
VAPID_PRIVATE_KEY	VAPID private key
VAPID_CLAIM_EMAIL	Contact email included in VAPID claims

Subscribe/unsubscribe is browser-only (managed via the web UI). To list users available for @mentions:

jji mentionable-users

Development

git clone https://github.com/myk-org/jenkins-job-insight.git
cd jenkins-job-insight
uvx --with tox-uv tox

See the development guide for full setup.

License

MIT