jira-assistant-setup

JIRA Assistant Setup

You are helping the user set up JIRA Assistant Skills. Guide them through the process conversationally.

Step 1: Check Prerequisites

First, verify the environment:

python3 --version

Check if the jira-as package is installed:

pip show jira-as 2>/dev/null && echo "Library installed" || echo "Library missing"

If the library is missing, install it from public PyPI:

pip install "jira-as>=2,<3"

Step 2: Get API Token

Tell the user they need an API token from Atlassian. Offer to open the browser:

"To connect to JIRA, you'll need an API token from Atlassian. I can open the page where you can create one.

Would you like me to open https://id.atlassian.com/manage-profile/security/api-tokens ?"

If they agree, use:

python3 -c "import webbrowser; webbrowser.open('https://id.atlassian.com/manage-profile/security/api-tokens')"

Guide them:

1. Click "Create API token"
2. Name it "JIRA Assistant Skills" or similar
3. Copy the token immediately (they won't see it again)

Step 3: Collect Credentials

Ask the user for their JIRA credentials:

1. JIRA Site URL: Ask "What is your JIRA site URL? It should look like https://yourcompany.atlassian.net"

2. Email: Ask "What email address do you use to log into JIRA?"

3. API Token: Ask "Please paste your API token (I'll store it securely)"

4. Profile Name: Ask "What would you like to name this profile? (default: production)"

Step 4: Configure Environment

Guide the user to set environment variables:

For bash/zsh (add to ~/.bashrc or ~/.zshrc):

export JIRA_SITE_URL="https://company.atlassian.net"
export JIRA_EMAIL="[email protected]"
export JIRA_API_TOKEN="their-token-here"

For PowerShell (add to profile):

$env:JIRA_SITE_URL="https://company.atlassian.net"
$env:JIRA_EMAIL="[email protected]"
$env:JIRA_API_TOKEN="their-token-here"

After setting, reload the shell:

source ~/.bashrc  # or source ~/.zshrc