jc jirac
Star on GitHub
Install Setup Features Commands TUI MCP FAQ
Style
v3 API CLI · TUI · MCP server

Run Jira from the terminal.

jirac is an open-source Jira CLI with a full keyboard-driven TUI, JQL search, worklogs, fix-version management, and an MCP server for AI-assisted workflows — without living in the web UI.

Install jirac Browse commands

Not affiliated with, endorsed by, or sponsored by Atlassian.

~/code/core — jirac
v3 API CLI · TUI · MCP server

The Jira CLI for terminal-first teams.

Browse, update, and automate Jira from your shell. Full TUI, JQL search, worklogs, fix versions, bulk actions, and an MCP server for agents.

Install jirac View source

Not affiliated with, endorsed by, or sponsored by Atlassian.

jirac split-pane TUI showing an issue list with a detail panel
v3 API CLI · TUI · MCP server

Your backlog, one keystroke away.

A daily-driver Jira CLI that lives where you already work — the terminal.

jirac — live
Install jirac See the TUI
Install

Pick your platform, copy one line.

Choose your OS and package manager — we’ll show the single command you need. Everything installs both jirac and the jirac-mcp server.

$

Need the full matrix or the standalone MCP binary? See INSTALL.md. OpenClaw users can grab the published skill or plugin:

Getting started

From zero to MCP in 5 steps.

For non-technical users — once the binary is installed, copy each line in order. Works the same for Codex and Claude Desktop.

  1. 1

    Install jirac

    Scroll up, pick your OS, and copy the single install line. It bundles both jirac and jirac-mcp.

    ↑ Use the picker above
  2. 2

    Confirm it works

    Open a fresh terminal and check that both binaries are on your PATH.

    jirac --version
  3. 3

    Log in to Jira

    You'll be prompted for your Jira site URL, email, and an API token. Credentials stay in your OS keyring.

    jirac auth login
  4. 4

    Register the MCP server

    Pick your AI app from the interactive picker — or pass --client <name> to skip the prompt.

    jirac mcp install
    $ jirac mcp install ? Pick the MCP client to install into: claude-code (writes ~/.claude.json) > claude-desktop (writes claude_desktop_config.json) cursor (writes ~/.cursor/mcp.json) codex (delegates to `codex mcp add` — cli + desktop) gemini-cli (delegates to `gemini mcp add`) opencode (writes opencode.jsonc) … 3 more [↑↓ to move · enter to select · type to filter]

    Direct shortcut: --client claude-desktop, --client codex, --client claude-code. Other targets: cursor, gemini-cli, opencode, antigravity, antigravity-cli, generic-json.

  5. 5

    Restart your AI app

    Fully quit Claude Desktop or Codex (Cmd+Q on macOS — closing the window isn't enough) and reopen it. The jira tools should appear in the tool list.

    jirac mcp doctor
What success looks like

Real installs, real apps.

After step 5, your AI app shows the jira MCP server enabled and running. Here's what it looks like in Claude Desktop and Codex.

Claude Desktop showing jira MCP server running with command /bin/jirac-mcp serve --transport stdio
Claude Desktop — jira MCP server status running.
Codex MCP servers settings showing jira server enabled
Codex — jira server enabled under MCP servers.

Stuck? jirac mcp doctor diagnoses missing binaries, broken config, and auth issues. Full reference in the MCP docs.

Why jirac

More than a thin REST wrapper.

A daily-driver toolkit for the people who live in a terminal — and the agents that work alongside them.

CLI · TUI · MCP

One tool, three surfaces: scriptable CLI, a keyboard-driven TUI, and an jirac-mcp server for AI agents.

JQL, the easy way

Interactive query builder by project, status, and assignee — plus saved JQL flows you can re-run instantly.

Reports in seconds

Daily standups, sprint summaries, worklog backfills across date ranges, and mention notifications — straight to the terminal.

Native bulk + moves

Change issue type, move across projects with native semantics, and bulk-comment, -transition, -update, or -create.

Custom fields, auto-mapped

Runtime field introspection per project — no manual YAML mapping to maintain. Built on the latest Jira API v3.

Cross-platform & fast

A single Rust binary for macOS, Linux, and Windows. Quick to install, quicker to run.

Command reference

Every command, one search box.

Filter by category or type what you’re trying to do — then copy the command. jirac --help always has the full story.

Terminal UI

A real interface, in your terminal.

Launch with jirac tui for keyboard- and mouse-driven issue management — browse, edit, transition, log work, and more without leaving the terminal. Ships with multiple themes, including GitHub Light and Kanagawa Wave.

jirac TUI issue list
Sortable issue list — browse and filter the backlog.
jirac split master-detail view
Split master-detail — list plus comments, worklog, links.
jirac interactive JQL builder
Interactive JQL builder — query without memorizing syntax.

Keyboard shortcuts

MCP server

Give your agent Jira access.

Expose Jira tools to any MCP client with jirac-mcp. jirac can even register it into your client config for you.

install & run
cargo install jira-mcp
jirac-mcp serve --transport stdio
one-command client install
jirac mcp install
# interactive picker, or pass --client
claude-code claude-desktop cursor gemini-cli codex opencode antigravity generic-json
portable JSON snippet
{
  "mcpServers": {
    "jira": {
      "command": "jirac-mcp",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}

Flags: --print shows the snippet, --dry-run previews without writing, --force overwrites an existing entry. Install helpers use your active Jira profile by default.

FAQ

Good to know.

Where do I get a Jira API token?

From your Atlassian account security settings, under “API tokens”. Run jirac auth login and paste your Jira URL, email, and token — it’s stored in ~/.config/jira/config.toml with 600 permissions.

Is this replacing the Jira web UI?

No. jirac complements the web UI for terminal-first and automation workflows — browsing, JQL, worklogs, transitions, versions, and MCP/agent access.

Does it support custom fields?

Yes. Custom fields are discovered dynamically per project at runtime, so there’s no manual field mapping to maintain.

Can I use jirac as my main Jira CLI?

Absolutely — it’s built to be a daily driver covering issue browsing, JQL search, worklogs, transitions, fix versions, project versions, bulk actions, and MCP workflows.

How do I copy text out of the TUI?

Hold Shift (iTerm2 / most Linux terminals) or Option (Terminal.app) while selecting. Under tmux, set set -g mouse on so events reach the TUI.

Stop context-switching to Jira.

Install jirac and run your backlog from the terminal in under a minute.

Install jirac Star on GitHub