jira-core

jira-core is an independent Rust library for the Jira ecosystem. It is not affiliated with, endorsed by, or sponsored by Atlassian.

jira-core is the shared library crate behind the jirac CLI and jirac-mcp. It provides the Jira HTTP client, authentication/config loading, typed models, field metadata helpers, and ADF conversion utilities.

This crate is versioned and released from the mulhamna/jira-commands workspace.

Install

[dependencies]
jira-core = "0.12"

What this crate provides

• JiraClient for Jira REST API v2 and v3 operations
• JiraConfig for config/env loading
• multi-profile config store helpers via JiraProfilesFile
• field metadata discovery and reuse
• issue, worklog, transition, attachment, and bulk-operation helpers
• Atlassian Document Format helpers for text and Markdown conversion
• typed model:: structs for every public response: Issue, Comment, Worklog, Attachment, Field, IssueLink, IssueType, RemoteLink, Component, Transition, JiraUser, Sprint, ProjectVersion — no more walking raw serde_json::Value

Example

use jira_core::{JiraClient, JiraConfig};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let config = JiraConfig::load()?;
    let client = JiraClient::new(config);

    let results = client
        .search_issues("project = MYPROJ AND status = 'In Progress'", None, Some(25))
        .await?;

    for issue in results.issues {
        println!("{}: {}", issue.key, issue.summary);
    }

    Ok(())
}

Configuration

Credentials are loaded from:

• ~/.config/jira/config.toml
• JIRA_PROFILE
• JIRA_URL
• JIRA_EMAIL
• JIRA_TOKEN
• JIRA_PROJECT
• JIRA_TIMEOUT_SECS
• JIRA_DEPLOYMENT
• JIRA_AUTH_TYPE
• JIRA_API_VERSION

That makes it easy to share config with jirac and jirac-mcp.

Example config shape:

current_profile = "work-cloud"

[profiles.work-cloud]
base_url = "https://yourcompany.atlassian.net"
email = "you@example.com"
token = "your_api_token"
project = "PROJ"
timeout_secs = 30
deployment = "cloud"
auth_type = "cloud_api_token"
api_version = 3

Related crates

• jira-commands for the CLI
• jira-mcp for MCP server integrations

More docs

See the root README for workspace-level installation and feature overview.