Atlassian Tools for VS Code

Manage Jira issues and Confluence pages directly from VS Code with an integrated UI and GitHub Copilot chat support.

Features

Jira Integration

• Interactive Preview UI: View and edit Jira issues in a rich webview with:
  • Status transitions with dropdown selection
  • Assignee management with user search
  • Priority updates
  • Field editing with @mentions support
  • Comment management (add, edit, delete)
  • Real-time sync between YAML files and preview
• Tree View: Browse your issues, recent items, and projects
• Activity Bar View: Access Jira and Confluence from the dedicated Atlassian view container
• YAML Editing: Edit issues in YAML format with Ctrl+S sync to Jira
• Language Model Tools: 43 tools for Copilot chat integration

Confluence Integration

• Page Editor: View and edit pages in a webview preview
• YAML Editing: Edit pages in YAML format with automatic sync
• Language Model Tools: 37 tools for page, comments, search, and metadata management

GitHub Copilot Chat Integration

Ask questions in Copilot chat like:

• "Get details for PROJ-123"
• "Search for Jira issues in project MYPROJ that are in progress"
• "Find Confluence pages about authentication"
• "Create a Confluence page with title 'API Documentation' in TECH space"

Configuration

Configure Atlassian credentials via VS Code settings or .env file:

• atlassianTools.atlassianBaseUrl - Your Atlassian base URL (e.g., https://yourcompany.atlassian.net)
• atlassianTools.atlassianEmail - Your Atlassian account email
• atlassianTools.atlassianApiToken - Atlassian API token

Copy .env.example to .env and fill in your credentials for local development.

Usage

UI Commands

Jira:

• Jira: Open Issue in YAML - Edit issue in YAML format
• Jira: Open Issue Preview - View issue in interactive webview
• Jira: Create New Issue - Create new issue from template
• Jira: Save to Jira - Save YAML changes to Jira (or use Ctrl+S)
• Jira: Add Comment - Add comment to issue
• Jira: Transition Issue - Change issue status

Confluence:

• Confluence: Open Page in YAML - Edit page in YAML format
• Confluence: Open Page Preview - View page in webview
• Confluence: Create New Page - Create new page from template
• Confluence: Save to Confluence - Save YAML changes (or use Ctrl+S)
• Confluence: Add Comment - Add comment to page
• Confluence: Delete Page - Delete page with confirmation

Language Model Tools

This extension provides 80 language model tools for GitHub Copilot integration:

Jira Tools (43):

• Issue operations: search (JQL), read, create, update, delete, assign, bulk fetch
• Comments: create, read, update, delete
• Worklogs: add, read, update, delete
• Transitions: get available, transition issue
• Issue links: read, create, delete
• Watchers: read, add, remove
• Attachments and votes: read, add, remove
• Bulk operations and metadata
• Project Overview:
  • Get project summary with metrics and progress
  • Get all epics with progress tracking
  • Get project versions (releases)
  • Get version progress and issue counts
  • Get project components and statuses
  • Get project roles and team members
• Epic Tracking:
  • Get all epics in a project
  • Get epic details with child issues and progress
  • Get progress for all epics (bird's eye view)
  • Add/remove issues from epics
• Version Management:
  • Create, update, delete versions
  • Release and archive versions
  • Get version-related issues
• Component Management:
  • Create, update, delete components
  • Get component issues and counts

Confluence Tools (37):

• Page Operations: search (CQL), read, create, update, delete, copy, move
• Page Context: history, versions, child pages, ancestors, labels, attachments
• Comments: footer and inline comments (v2 API)
• Comment Operations: create, reply, update, delete, resolve, reopen
• Space Operations: get spaces, space details, pages in space
• Search Operations: CQL search, title search, full-text search, Jira key search
• User & Metadata: current user, user search, page watchers

See package.json for full tool definitions and schemas.

Development

Setup

npm install
npm run compile

npm Scripts

• npm run lint - Run ESLint
• npm run compile - Compile TypeScript
• npm run watch - Watch mode compilation
• npm run verify - Test Atlassian connectivity
• npm run test-jira-integration - Run Jira integration tests (creates and cleans up test data)
• npm run test-confluence-integration - Run Confluence integration tests (creates and cleans up test data)
• npm run test-jira-ui - Run Jira UI validation script
• npm run test-confluence-ui - Run Confluence UI validation script

Contributing

See .github/copilot-instructions.md for coding standards and contribution guidelines.

License

See LICENSE.md.