Metadata-Version: 2.4
Name: jira-ai-agent-parth
Version: 0.1.2
Summary: AI-powered Jira CLI assistant
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: python-dotenv
Requires-Dist: keyring
Requires-Dist: langchain
Requires-Dist: langchain-core
Requires-Dist: langchain-mistralai
Requires-Dist: langgraph
Requires-Dist: langgraph-checkpoint-sqlite

# Jira AI Agent — Powered by Parth

An AI-powered Jira CLI assistant that lets you manage Jira using natural language directly from your terminal.

**Powered by Parth**

---

## 🚀 Installation

Install the package directly from PyPI:

```bash
pip install jira-ai-agent-parth
```

After installation, start the Jira AI Agent with:

```bash
jira-ai
```

---

# 🧠 What is Jira AI Agent?

Jira AI Agent allows you to interact with your Jira workspace using normal language instead of manually navigating through Jira.

For example, instead of manually searching for an issue, you can simply ask:

```text
Get details of SCRUM-1
```

Or:

```text
Show me all issues from the SCRUM project
```

The AI Agent understands your request and uses Jira APIs to perform the required operation.

---

# ⚙️ First-Time Setup

When you run:

```bash
jira-ai
```

for the first time, you need to configure your Jira and AI credentials.

You will need:

1. Jira URL
2. Jira Email
3. Jira API Token
4. Mistral API Key

---

# 🤖 Recommended AI Model — Mistral AI

This project currently recommends **Mistral AI**.

Mistral provides API access that is simple to configure and is a good option for running this Jira AI Agent.

## Generate your Mistral API Key

Open:

https://console.mistral.ai/

Create an account or log in.

Then generate a new API key.

Copy the API key and keep it safe.

**Never share your API key publicly.**

When the Jira AI Agent asks for your Mistral API key, paste the generated key.

---

# 🔐 Jira Configuration

You will also need your Jira credentials.

## Jira URL

Enter your Jira workspace URL.

Example:

```text
https://your-company.atlassian.net
```

## Jira Email

Use the email address associated with your Jira account.

Example:

```text
your-email@example.com
```

## Jira API Token

Generate a Jira API token from your Atlassian account.

Open:

https://id.atlassian.com/manage-profile/security/api-tokens

Create a new API token and copy it.

**Never share your Jira API token publicly.**

---

# 🛠️ Configuration

During the first run, the CLI will ask you for the required configuration.

The configuration includes:

```text
Jira URL
Jira Email
Jira API Token
Mistral API Key
```

The configuration is stored locally on your machine and is used for future sessions.

You do not need to enter the credentials every time you start the application.

---

# 🔄 Change Configuration

If you want to change your Jira credentials or Mistral API key later, you don't need to reinstall the package.

Run:

```bash
jira-ai config
```

You can then update your configuration.

For example, you can change:

* Jira URL
* Jira email
* Jira API token
* Mistral API key
* AI model configuration

After changing the configuration, simply start the agent again:

```bash
jira-ai
```

---

# 💬 Using the Jira AI Agent

Start the application:

```bash
jira-ai
```

You will see:

```text
Jira AI Agent started.
Type 'exit' to quit.
```

You can now communicate with Jira using natural language.

---

# 🔎 Get Issue Details

Example:

```text
Get details of SCRUM-1
```

The agent can return information such as:

* Issue key
* Summary
* Status
* Priority
* Description
* Assignee
* Other available issue information

---

# 📋 Search Issues

Example:

```text
Show me all issues from the SCRUM project
```

You can also ask natural-language questions such as:

```text
Find all issues in the SCRUM project
```

or:

```text
Show me the issues currently in progress
```

---

# ✏️ Update an Issue

Example:

```text
Update SCRUM-2 summary
```

The agent will ask what you want the new summary to be.

For example:

```text
Implement OAuth and Google authentication
```

Before performing important updates, the agent can ask for confirmation.

---

# 🗑️ Delete an Issue

Example:

```text
Delete SCRUM-2
```

Because deletion is a destructive operation, make sure you confirm the operation before allowing the agent to perform it.

---

# 💬 Add a Comment

Example:

```text
Add a comment to SCRUM-1
```

The agent will ask for the comment text.

For example:

```text
Development has started on this issue.
```

---

# 👤 Assign an Issue

Example:

```text
Assign SCRUM-1 to John
```

The agent can use Jira users available to your account to identify the appropriate assignee.

If the user cannot be identified, provide the user's Jira account information when requested.

---

# 🔄 Change Issue Status

Example:

```text
Move SCRUM-1 to Done
```

The agent can check the available Jira transitions and perform the requested transition when it is available in your Jira workflow.

---

# 🧩 Natural Language

You don't have to remember exact commands.

You can simply describe what you want.

For example:

```text
What is the status of SCRUM-1?
```

```text
Show me SCRUM issues.
```

```text
Who is assigned to SCRUM-1?
```

```text
Add a comment saying development has started on SCRUM-1.
```

```text
Change SCRUM-1 priority.
```

```text
Move SCRUM-1 to Done.
```

The AI Agent will determine which Jira operation is required.

---

# 🔒 Security

Your Jira credentials and AI API keys are sensitive information.

Never share:

```text
Jira API Token
Mistral API Key
```

Do not commit these values to GitHub or any public repository.

If you believe a token has been exposed, revoke it and generate a new one.

---

# 🧪 Example Complete Setup

Install:

```bash
pip install jira-ai-agent-parth
```

Start:

```bash
jira-ai
```

Configure:

```text
Jira URL:
https://your-company.atlassian.net

Jira Email:
your-email@example.com

Jira API Token:
your-jira-token

Mistral API Key:
your-mistral-api-key
```

Then start using Jira:

```text
Ask Jira: Get details of SCRUM-1
```

---

# 🔄 Updating the Package

To update to the latest version:

```bash
pip install --upgrade jira-ai-agent-parth
```

Check the installed version:

```bash
pip show jira-ai-agent-parth
```

---

# 🆘 Troubleshooting

## `jira-ai` command not found

Try:

```bash
python -m pip install --upgrade jira-ai-agent-parth
```

Then restart your terminal.

---

## Configuration needs to be changed

Run:

```bash
jira-ai config
```

---

## Mistral API problems

Verify that:

* Your Mistral API key is correct.
* Your Mistral account has API access.
* You generated the key from the official Mistral console.

Mistral Console:

https://console.mistral.ai/

---

## Jira authentication problems

Verify:

* Jira URL is correct.
* Jira email is correct.
* Jira API token is valid.
* Your Jira account has permission to access the project.

Generate/manage Jira API tokens here:

https://id.atlassian.com/manage-profile/security/api-tokens

---

# 📦 Package

PyPI:

https://pypi.org/project/jira-ai-agent-parth/

Install:

```bash
pip install jira-ai-agent-parth
```

---

# 🛠️ Technology

This project uses:

* Python
* LangChain
* LangGraph
* Mistral AI
* Jira REST API
* SQLite
* Requests

---

# 👨‍💻 Author

**Parth**

**Powered by Parth**

Built to make Jira management easier through AI-powered natural-language interaction.

---

## ⭐ If you find this project useful

Install it, try it with your Jira workspace, and use the natural-language interface to manage your Jira issues directly from your terminal.
