# Jira Assignment Watcher

A background monitor that polls Jira for issues recently assigned to you and emits notifications to Claude Code via the monitor protocol. Never miss a new assignment while working in your terminal.

❯cat jira-assignment-plugin/ARCHITECTURE.md

## How It Works

The script polls the Jira REST API every 60 seconds for issues assigned to you in the last 24 hours. Each result is compared against a local seen-assignments.json file. New items are emitted as one-line stdout events — the Claude Code monitor protocol picks these up and surfaces them as notifications in your terminal session.

Claude Code Monitor ──reads stdout──▶ Jira Watcher (Node.js)
                                                 └── Jira REST API (poll every 60 s)
                                                 └── seen-assignments.json (dedup)
                                                 └── stdout: new assignment events

❯jira-assignment-plugin --demo

## Screenshots

jira-watcher — monitor running

❯  # Started as Claude Code monitor
   Polling Jira every 60 s · user: you@company.com

   [10:02:11]  No new assignments
   [10:03:11]  No new assignments
   [10:04:11]  ✓  1 new assignment:
              ENG-1842 · "Fix login redirect on mobile"
              Priority: High · Reporter: Sarah Chen
              → https://company.atlassian.net/browse/ENG-1842

jira-watcher — Claude Code notification

   ╔══════════════════════════════════════════╗
   ║  Jira Assignment Watcher                 ║
   ║──────────────────────────────────────────║
   ║  New issue assigned to you:              ║
   ║  ENG-1842 · "Fix login redirect"         ║
   ║  Priority: High                          ║
   ╚══════════════════════════════════════════╝

   Claude Code surfaced this at 10:04:11

❯grep -n "## Features" jira-assignment-plugin/README.md

## Features

+Polls Jira for new assignments
+Claude Code monitor protocol integration
+Persistent seen-assignments tracking
+Zero-noise — only new assignments notified

❯jira-assignment-plugin --compare

## vs. The Field

Feature	Jira Assignment Watcher	Jira email alerts	Slack Jira bot
Claude Code monitor protocol	✓	✗	✗
Zero noise (new items only)	✓	✗	partial
Terminal-native notification	✓	✗	✗
Free / open source	✓	✓	✗
Works without email/Slack	✓	✗	✗

❯cd jira-assignment-plugin && cat INSTALL.md

## Installation

Get a Jira API token

Set environment variables

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@company.com
export JIRA_API_TOKEN=your-token

Register as a Claude Code monitor

Add to .claude/settings.json so Claude Code starts the watcher automatically.

{
  "monitors": [
    {
      "command": "node",
      "args": ["/path/to/jira-assignment-plugin/bin/watch-jira.mjs"]
    }
  ]
}

❯cat jira-assignment-plugin/package.json | jq '.dependencies | keys'

## Tech Stack

Node.jsJira REST APIClaude Code Monitor Protocol

←Gmail MCP Server ↑ all packages Jira Automation→