Jira Cloud

Connect Operator to Jira Cloud for issue tracking and project management.

Prerequisites

Jira Cloud account (not Jira Server/Data Center)
Project with appropriate permissions
API token for authentication

Create API Token

Go to Atlassian Account Settings
Click “Create API token”
Name it “Operator” and copy the token

Configuration

Set the required environment variables:

export OPERATOR_JIRA_DOMAIN="your-org.atlassian.net"
export OPERATOR_JIRA_EMAIL="your-email@example.com"
export OPERATOR_JIRA_API_KEY="your-api-token"

Add Jira to your Operator configuration (domain is the key):

# ~/.config/operator/config.toml

[kanban.jira."your-org.atlassian.net"]
enabled = true
email = "your-email@example.com"
api_key_env = "OPERATOR_JIRA_API_KEY"  # default

[kanban.jira."your-org.atlassian.net".projects.PROJ]
sync_user_id = "your-jira-account-id"
collection_name = "dev_kanban"

Multiple Jira Workspaces

You can configure multiple Jira workspaces with custom environment variable names:

[kanban.jira."work.atlassian.net"]
enabled = true
email = "work@company.com"
api_key_env = "OPERATOR_JIRA_WORK_API_KEY"

[kanban.jira."personal.atlassian.net"]
enabled = true
email = "personal@example.com"
api_key_env = "OPERATOR_JIRA_PERSONAL_API_KEY"

Issue Mapping

Operator maps Jira issue types to ticket types:

Jira Type	Operator Type
Bug	FIX
Story	FEAT
Task	FEAT
Spike	SPIKE

Syncing Issues

Pull issues from Jira:

operator sync

Per-Project Configuration

Configure sync settings for each project:

[kanban.jira."your-org.atlassian.net".projects.PROJ]
sync_user_id = "5e3f7acd9876543210abcdef"  # Your Jira accountId
sync_statuses = ["To Do", "In Progress"]    # Statuses to sync (empty = default only)
collection_name = "dev_kanban"               # IssueTypeCollection to use

Troubleshooting

Authentication errors

Verify your credentials:

curl -u email:token https://your-org.atlassian.net/rest/api/3/myself

Missing issues

Check your JQL query and permissions in Jira.