# jenkins-job-insight

> Turn Jenkins failures into actionable analysis, team review, and ready-to-file bugs.

## Getting Started

- [Running Your First Analysis](quickstart.md): Launch the service with the fastest supported setup, configure the minimum Jenkins and AI settings, register your profile, and inspect your first analysis from the CLI and web UI.

## User Guides

- [Analyzing Jenkins Jobs](analyzing-jenkins-jobs.md): Queue a Jenkins build for analysis, choose per-run overrides, and understand how waiting, artifact downloads, and Jira enrichment affect the result.
- [Analyzing JUnit XML and Raw Failures](analyzing-junit-xml-and-raw-failures.md): Send raw failures or JUnit XML straight to the API and get structured analysis back when you want to work without a live Jenkins job.
- [Monitoring and Re-Running Analyses](monitoring-and-rerunning-analyses.md): Follow queued, waiting, running, failed, and completed jobs, then launch a re-analysis with adjusted settings when a run times out or needs another pass.
- [Reviewing, Commenting, and Reclassifying Failures](reviewing-commenting-and-reclassifying-failures.md): Use the report UI to inspect grouped failures, mark reviews complete, leave team comments, and override AI classifications when human judgment should win.
- [Managing Your Profile and Personal Tokens](managing-your-profile-and-personal-tokens.md): Set your display name, store GitHub and Jira credentials, validate them, and make issue creation work under your own identity instead of shared server credentials.
- [Tracking Failure History](tracking-failure-history.md): Search recurring failures, inspect a single test's trend over time, and use stored classifications and comments to spot flaky or systemic problems faster.
- [Creating GitHub Issues and Jira Bugs](creating-github-issues-and-jira-bugs.md): Preview generated issue content, pick the target repository or Jira project, edit the final text, and file follow-up work directly from an analysis report.
- [Improving Analysis with Repository Context](improving-analysis-with-repository-context.md): Give the AI better code context with test repositories, additional repositories, raw prompts, and artifact settings so the analysis can point to the right code and evidence.
- [Adding Peer Review with Multiple AI Models](adding-peer-review-with-multiple-ai-models.md): Configure peer providers and models, tune debate rounds, and use multi-model review when you want higher-confidence triage for difficult failures.
- [Pushing Classifications to Report Portal](pushing-classifications-to-report-portal.md): Sync JJI classifications into matching Report Portal items, including child-job runs, and handle unmatched or partially successful pushes without losing track of what happened.
- [Managing Admin Users and API Keys](managing-admin-users-and-api-keys.md): Create admin accounts, rotate keys, change roles, remove access, and use admin authentication safely from the UI, CLI, and API.

## Reference

- [CLI Command Reference](cli-command-reference.md): Look up every `jji` command, option, config-file interaction, and output mode when you need exact syntax.
- [REST API Reference](rest-api-reference.md): Look up every endpoint, request field, query parameter, response shape, and status code for analysis, results, history, integrations, auth, and admin workflows.
- [Configuration and Environment Reference](configuration-and-environment-reference.md): Look up server environment variables, Docker Compose settings, `~/.config/jji/config.toml` fields, feature toggles, authentication knobs, and per-request override behavior.