ralphmoran/ticket-lens

<div align="center"

TicketLens

<div align="center" <img src="https://img.shields.io/npm/v/ticketlens?style=flat-square&color=6c63ff&label=version" / <img src="https://img.shields.io/npm/dm/ticketlens?style=flat-square&color=06b6d4&label=downloads" / <img src="https://github.com/ralphmoran/ticket-lens/actions/workflows/test.yml/badge.svg?style=flat-square" / <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" / <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" / </div

</div

Your AI assistant shouldn't need to read your tickets.

Works alongside Atlassian MCP — Atlassian MCP writes the tickets; TicketLens tells you which ones need you right now.

<div align="center"<img src="docs/demos/fetch.gif" alt="ticketlens CNV1-2 demo" width="700" /</div

---

What is TicketLens?

TicketLens is a local-first Jira CLI that preprocesses ticket context on your machine and hands your AI tools a clean, compressed brief — instead of dumping raw Jira API JSON into your session. It supports Jira Cloud, Server, and Data Center, works with any AI tool that accepts text, and runs independently of any AI session.

Zero npm dependencies. Node.js built-ins only.

---

Why TicketLens?

• Privacy — ticket content never leaves your machine; no cloud relay, no data sent to Anthropic or anyone else
• 60–80% token savings — structured briefs instead of verbose Jira JSON; 4-hour cache by default
• Scriptable — standard CLI output: pipe to cron, git hooks, CI/CD, or any LLM tool
• Multi-profile — connect multiple Jira instances simultaneously; auto-route by ticket prefix or project path
• Attachments included — images, PDFs, and text files downloaded locally; Claude Code reads them as context
• Confluence pages — linked Confluence pages fetched and included in the brief automatically (Jira only)

---

Quick Start

npm install -g ticketlens
ticketlens init          # Guided setup: Jira, GitHub Issues, or Linear — connection test included
ticketlens CNV1-2        # Fetch a ticket brief
ticketlens triage        # Scan your assigned tickets

Or without installing: