Jira Agent prepares Jira ticket context as structured Markdown so AI coding agents can work reliably without opening Jira. The extension does not edit code; it only generates context files and optional plans.
Features
Connect to Jira Cloud
Browse issues in a TreeView
Generate .codex/active-ticket.md and archive tickets under tickets/
(Optional) Generate an implementation plan in .codex/active-plan.md
Prepare a ready-to-paste prompt for Codex/Copilot Chat
Screenshots
TODO: Add TreeView overview
TODO: Add issue detail view
TODO: Add generated context example
Run and Debug
npm install
npm run compile
Press F5 in VS Code or use the launch configuration: Run Jira Agent Extension
Tests
npm test (runs the VS Code extension test harness)
Troubleshooting
See TROUBLESHOOTING.md for common setup and runtime errors.
Packaging and Publishing
Set publisher and repository.url in package.json
npm install
npm run package (generates a VSIX)
npm run publish (requires VS Code Marketplace credentials)
Versioning
Bump version in package.json per release
Tag releases in git (recommended)
Release Automation
Use the Release GitHub Actions workflow to package a VSIX from a tagged version.
The workflow validates the input version matches package.json.
Configure Jira Credentials (Placeholder)
Credentials are stored in VS Code SecretStorage and are not written to disk. Configuration UI will be added in Milestone 1.
For now, settings are defined in Settings → Extensions → Jira Agent:
jiraAgent.jiraBaseUrl
jiraAgent.jiraEmail
Set the API token via the command: Jira Agent: Set Jira API Token.
Alternatively, run Jira Agent: Setup Jira Credentials to use the guided setup flow.
Agent Handoff (Manual)
Use Jira Agent: Prepare Agent Prompt to generate a prompt that includes ticket context (and plan if present). The prompt opens in a new editor and is copied to your clipboard so you can paste it into Codex/Copilot Chat.
