Configure Jira API credentials for importing issues
Configures Jira API credentials for importing issues into Claude Code.
/plugin marketplace add conallob/jira-beads-sync/plugin install conallob-jira-beads-sync@conallob/jira-beads-syncConfigure Jira credentials to enable importing issues from Jira. This is a one-time setup required before using the import-jira command.
Jira credentials can be configured in three ways (in order of precedence):
Run the interactive configuration command:
jira-beads-sync configure
This will prompt for:
https://jira.example.com)The configuration is saved to ~/.config/jira-beads-sync/config.yml
Set these environment variables:
export JIRA_BASE_URL=https://jira.example.com
export JIRA_USERNAME=your-email@example.com
export JIRA_API_TOKEN=your-api-token
Environment variables override the config file.
Manually create ~/.config/jira-beads-sync/config.yml:
jira:
base_url: https://jira.example.com
username: your-email@example.com
api_token: your-api-token
Security Note: API tokens should be treated like passwords. Never commit them to version control.
After configuration, test the connection by importing a known issue:
jira-beads-sync quickstart <test-issue-key>
If you see "invalid configuration" or authentication errors, run jira-beads-sync configure again.
User: Configure Jira credentials
Claude: I'll help you configure Jira credentials. This is stored securely in your home directory.
[Runs: jira-beads-sync configure]
Jira Configuration
==================
Jira Base URL (e.g., https://jira.example.com): https://company.atlassian.net
Jira Username/Email: user@example.com
Jira API Token: ************************
✓ Configuration saved successfully
Configuration is stored at: ~/.config/jira-beads-sync/config.yml
To get a Jira API token, visit:
https://id.atlassian.com/manage-profile/security/api-tokens
You can now use: import-jira <jira-url-or-key>
/browse/ or issue keys~/.config/jira-beads-sync/config.yml has restricted permissions (0600)