jira

πŸ‘‹ Introduction

A headless, dependency-free Jira Cloud client for Node, with ADF conversion, JQL helpers and shared config loading.

@kud/jira is a small TypeScript library that talks to the Jira Cloud REST API through plain fetch. It has no runtime dependencies and no hidden state, so the same client behaves identically in a CLI, an MCP server, a TUI or a test.

What's here

  • 🧭 Usage β€” creating a client, paging through searches, handling errors and faking fetch in tests
  • πŸ“š API reference β€” every client method, grouped by area: issues, comments, worklogs, links, projects, agile and instance metadata
  • πŸ”Ž JQL and search β€” building queries from options and turning a search box into JQL
  • πŸ“ Content and attachments β€” converting between ADF and Markdown, locating where attachments were used, downloading them safely
  • βš™οΈ Configuration β€” the environment variables and config file that loadConfig resolves

On this page