From 28378ac13eb016153a77d93e91da2ba73b7c8db4 Mon Sep 17 00:00:00 2001 From: Angelo Girardi Date: Thu, 20 Nov 2025 17:36:50 -0600 Subject: [PATCH 1/4] fix: readme issues --- DEVELOPER_GUIDE.md | 611 ++++++++++++++++++++++++++++++++++++++++++ README.md | 651 +++++++-------------------------------------- package.json | 2 +- 3 files changed, 710 insertions(+), 554 deletions(-) create mode 100644 DEVELOPER_GUIDE.md diff --git a/DEVELOPER_GUIDE.md b/DEVELOPER_GUIDE.md new file mode 100644 index 0000000..1094ed0 --- /dev/null +++ b/DEVELOPER_GUIDE.md @@ -0,0 +1,611 @@ +# DevBuddy - Multi-Platform Ticket Management for Developers + +[![Version](https://img.shields.io/github/v/release/angelo-hub/devbuddy?label=version)](https://github.com/angelo-hub/devbuddy/releases) +[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![Downloads](https://img.shields.io/visual-studio-marketplace/d/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![License](https://img.shields.io/badge/license-MIT%20%2B%20Pro-blue)](./LICENSE) + +**Transform your development workflow with AI-powered ticket management, supporting Linear, Jira, and more.** + +> **Privacy-First:** Works with or without AI. Organizations with strict security policies can disable external AI and use intelligent rule-based analysis instead. + +--- + +## At a Glance + +| Feature | Description | Platforms | +|---------|-------------|-----------| +| **Sidebar Management** | View and manage all tickets from VS Code | Linear, Jira | +| **AI Workflows** | Generate PR summaries and standups automatically | Linear, Jira | +| **TODO Converter** | Convert TODOs to tickets with automatic code permalinks | Linear, Jira | +| **Chat Participant** | Ask `@devbuddy` questions in natural language | Linear (Jira soon) | +| **Branch Integration** | Create and manage branches directly from tickets | Linear, Jira | +| **Monorepo Support** | Intelligent package detection and validation | All platforms | + +--- + +## Supported Platforms + +| Platform | Status | Features | +|----------|--------|----------| +| **Linear** | ✅ Full Support | Complete feature set with AI integration | +| **Jira Cloud** | ✅ Full Support | Feature parity with Linear - AI, branches, webviews | +| **Jira Server (beta)** | 🚧 Beta | Self-hosted Jira support - testing phase | +| **Monday.com** | ⏳ Planned | Future release | +| **ClickUp** | ⏳ Planned | Future release | + +--- + +## Why DevBuddy? + +Stop context switching. Manage tickets, generate documentation, and track work without leaving VS Code. + +| Task | Manual Workflow | With DevBuddy | Time Saved | +|------|----------------|---------------|------------| +| **Create ticket from TODO** | Open browser, create ticket, copy ID, paste in code, add permalink manually | Right-click → Convert TODO | 5 min → 10 sec | +| **Track TODOs across files** | Create ticket, manually update 4 files with ticket ID | Create once → paste in 3 more locations | 10 min → 30 sec | +| **Generate PR summary** | Review changes, write description, list affected packages | One command → AI generates full summary | 15 min → 1 min | +| **Daily standup** | Review commits, check tickets, write update | One click → AI generates standup | 10 min → 30 sec | +| **Update ticket status** | Open browser, find ticket, update status | Right-click in sidebar → select new status | 1 min → 5 sec | + +--- + +## Quick Start + +### 1. Install Extension + +**From VS Code Marketplace:** +1. Open VS Code +2. Go to Extensions (Cmd/Ctrl + Shift + X) +3. Search for "DevBuddy" +4. Click Install + +**Or install from command line:** +```bash +code --install-extension angelogirardi.dev-buddy +``` + +### 2. Choose Your Platform + +Open Settings and set your preferred platform: + +```json +{ + "devBuddy.provider": "linear" // or "jira" +} +``` + +| Setting Value | Platform | Configuration Required | +|---------------|----------|------------------------| +| `"linear"` | Linear | API token from linear.app/settings/api | +| `"jira"` | Jira Cloud | Site URL, email, API token | + +### 3. Configure Authentication + +
+For Linear Users + +1. Get your API key: [linear.app/settings/api](https://linear.app/settings/api) +2. Open Command Palette: `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) +3. Run: `DevBuddy: Update Linear API Key` +4. Paste your API token + +**Optional Configuration:** +```json +{ + "devBuddy.linear.organization": "yourorg", + "devBuddy.linear.teamId": "team-id-here" +} +``` + +
+ +
+For Jira Cloud Users + +1. Open Command Palette: `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) +2. Run: `DevBuddy: Setup Jira Cloud` +3. Enter your Jira site URL (e.g., `yourcompany.atlassian.net`) +4. Enter your email address +5. Create an API token: [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) +6. Paste the API token when prompted + +**Tip:** You can paste any Jira ticket URL and DevBuddy will extract your site URL automatically. + +
+ +### 4. Start Using DevBuddy + +Three ways to interact with DevBuddy: + +1. **Sidebar:** Click the checklist icon in the Activity Bar +2. **Chat:** Open VS Code Chat → type `@devbuddy` +3. **Commands:** Press `Cmd+Shift+P` → search "DevBuddy" + +--- + +## Core Features + +### Universal Ticket Management + +Works across all supported platforms with a consistent interface. + +**Sidebar Features:** +- View all assigned tickets/issues organized by status +- Quick actions: Update status, assign, comment +- Filter by status, project, priority +- Visual priority indicators +- One-click to open ticket details + +![Sidebar Demo - Placeholder](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/sidebar-demo.gif) + +**Key Benefits:** +- Single interface for multiple platforms +- Real-time synchronization +- Keyboard shortcuts for common actions +- Inline actions without opening browser + +--- + +### TODO to Ticket Converter + +Transform TODO comments into fully-tracked tickets with automatic code permalinks. Works with both Linear and Jira Cloud. + +![TODO Converter Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/todo-converter-demo.gif) + +**How it works:** +1. Write a TODO comment in your code +2. Right-click → "Convert TODO to Ticket" +3. Review auto-generated ticket with permalink +4. Choose: Replace TODO, Add More TODOs, or Link Existing TODOs +5. Works seamlessly with Linear or Jira Cloud + +**What gets included automatically:** +- File path and line number +- GitHub/GitLab/Bitbucket permalink to exact code location +- 5 lines of surrounding code context +- Current branch and commit SHA +- Syntax highlighting in Linear + +**Multi-File Workflow:** + +![Add More TODOs Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/add-more-todos.gif) + +After creating a ticket, use "Add More TODOs" to: +- Navigate to multiple files with Quick Open (Cmd+P) +- Paste ticket reference in each location +- Track complex refactors across your codebase +- Keep all TODOs linked to the same ticket + +**Key Benefits:** +- Zero context loss for your team +- Permanent links that survive refactoring +- 10x faster than manual ticket creation +- Works with GitHub, GitLab, and Bitbucket + +[Learn more about TODO Converter](./docs/features/todo-converter/) + +--- + +### AI-Powered PR Summaries + +Generate comprehensive pull request descriptions automatically, with special support for monorepos. Works with both Linear and Jira Cloud. + +![PR Summary Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/pr-summary-demo.gif) + +**Monorepo Intelligence:** +- Automatically detects affected packages +- Analyzes changes per package separately +- Shows scope of your changes +- Warns if too many packages are modified + +**What gets generated:** +- High-level overview of changes +- Per-package breakdown in monorepos +- Testing notes and checklist +- Linked tickets (Linear or Jira) +- Breaking changes detection +- Migration notes if needed + +**PR Template Integration:** +- Reads your `.github/pull_request_template.md` +- Fills in sections automatically +- Preserves formatting and checkboxes +- Keeps custom fields and instructions + +**Key Benefits:** +- Works with monorepos out of the box +- Customizable writing tone (professional, casual, technical, concise) +- Includes git diff analysis +- Ready to paste into GitHub/GitLab + +[Learn more about PR Summaries](./docs/features/pr-standup/) + +--- + +### AI Standup Generator + +Let AI generate your standup update automatically from commits and ticket activity. Works with both Linear and Jira Cloud. + +![Standup Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/standup-demo.gif) + +**How it works:** +1. Open Standup Builder +2. Review your recent commits and Linear tickets +3. Click "Generate with AI" +4. Get formatted standup with Yesterday/Today/Blockers +5. Copy and share + +**What gets analyzed:** +- Git commits in configurable time window (default: 24 hours) +- Tickets you've updated (Linear or Jira) +- Code changes across packages +- Commit message context +- Branch associations + +**Customization:** +- Adjust time window (24 hours, 2 days, since last standup) +- Choose writing tone (professional, casual, technical, concise) +- Select AI model preference +- Edit generated content before sharing + +**Key Benefits:** +- Never forget what you worked on +- Consistent standup format +- Takes 30 seconds instead of 10 minutes +- Automatically links to relevant tickets + +[Learn more about Standup Builder](./docs/features/pr-standup/) + +--- + +### Chat Participant + +Talk to DevBuddy using the VS Code Chat interface. + +**Available Commands:** +- `/tickets` - Show your current tickets +- `/standup` - Generate standup update (Linear) +- `/pr` - Generate PR summary (Linear) +- `/status` - Update ticket status + +**Natural Language Queries:** +``` +@devbuddy what am I working on? +@devbuddy show me ENG-123 (Linear) or PROJ-456 (Jira) +@devbuddy create a ticket for authentication bug +@devbuddy update ENG-456 to in progress +@devbuddy generate my standup +@devbuddy generate PR summary +``` + +**Key Benefits:** +- Works with both Linear and Jira +- Natural conversation about your work +- Quick access to ticket information +- No need to remember command names + +--- + +## Platform-Specific Features + +### Linear Features + +Linear users get the complete DevBuddy experience with full feature support. + +| Feature | Status | Description | +|---------|--------|-------------| +| View Tickets | ✅ | Rich sidebar with webview panels | +| Create/Edit Tickets | ✅ | Full ticket management interface | +| Status Management | ✅ | Visual workflow with all states | +| Branch Creation | ✅ | Create and manage branches from tickets | +| Branch Association | ✅ | Link existing branches to tickets | +| TODO Converter | ✅ | Convert TODOs with automatic permalinks | +| AI Standup | ✅ | Generate standup from commits and tickets | +| AI PR Summary | ✅ | Generate PR descriptions with monorepo support | +| Chat Participant | ✅ | Full chat integration with all commands | +| Comments | ✅ | Read and add comments to tickets | +| Sub-issues | ✅ | View and manage sub-issues | + +**Branch Integration:** + +![Linear Branch Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/linear-sidebar-demo.gif) + +- Create branches with smart naming (conventional, simple, or custom) +- Auto-detect associations based on branch names +- Checkout associated branches from sidebar +- View linked PRs directly in ticket panel + +### Jira Cloud Features + +Jira Cloud users get the complete DevBuddy experience with full feature parity to Linear. + +| Feature | Status | Description | +|---------|--------|-------------| +| View Issues | ✅ | Rich sidebar with webview panels | +| Create/Edit Issues | ✅ | Full issue management interface in VS Code | +| Status Transitions | ✅ | Full workflow transition support | +| Branch Creation | ✅ | Create and manage branches from issues | +| Branch Association | ✅ | Link existing branches to issues | +| TODO Converter | ✅ | Convert TODOs with automatic code permalinks | +| AI Standup | ✅ | Generate standup from commits and Jira activity | +| AI PR Summary | ✅ | Generate PR descriptions with monorepo support | +| JQL Search | ✅ | Advanced search with Jira Query Language | +| Comments | ✅ | Read and add comments | +| Sprints & Boards | ✅ | View and manage sprints | +| Runtime Validation | ✅ | Production-grade API validation with Zod v4 | +| Chat Participant | ⏳ | Coming soon | +| Sub-tasks | ✅ | View and manage sub-tasks | +| Attachments | ✅ | View and download attachments | + +**Full Feature Set:** + +![Jira Sidebar Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/jira-sidebar-demo.gif) + +- **Manage issues** directly in VS Code without browser context switching +- **View and edit** issues with rich webview panels +- **Create branches** with smart naming (conventional, simple, or custom) +- **Auto-detect associations** based on branch names +- **Generate standups** from Jira activity and git commits +- **AI-powered PR summaries** with monorepo intelligence +- **Convert TODOs to tickets** with automatic code permalinks +- **Update status** with workflow transitions +- **Quick actions**: Add comment, assign, copy issue key +- **JQL search** for advanced filtering +- **Sprint management** and agile workflows + +--- + +## AI Configuration + +### Privacy-First AI Options + +DevBuddy gives you complete control over AI usage. + +**Option 1: Use AI (Default)** + +Leverage VS Code's Language Model API (GitHub Copilot) for intelligent summaries. + +**Supported Models:** +- GPT-4o (recommended) +- GPT-4.1 +- GPT-4 Turbo +- Gemini 2.0 Flash + +**Configuration:** +```json +{ + "devBuddy.ai.model": "auto", // Auto-selects best available + "devBuddy.writingTone": "professional" // or casual, technical, concise +} +``` + +**Option 2: Privacy Mode (No External AI)** + +Perfect for regulated industries or strict security policies. + +```json +{ + "devBuddy.ai.disabled": true +} +``` + +DevBuddy will use intelligent rule-based analysis instead: +- Pattern detection in commits +- Commit message analysis +- File change categorization +- 100% local processing +- Works offline + +--- + +## Monorepo Support + +DevBuddy is built for monorepos with intelligent package detection. + +**Configuration:** +```json +{ + "devBuddy.packagesPaths": ["packages/", "apps/", "libs/"], + "devBuddy.maxPackageScope": 2, // Warn if > 2 packages modified + "devBuddy.baseBranch": "main" +} +``` + +**Features:** +- Automatic package detection +- Per-package change analysis in PR summaries +- Scope validation and warnings +- Package-aware commit analysis +- Multi-package workflow support + +--- + +## Commands Reference + +### Universal Commands + +Work with any configured platform: + +| Command | Description | Shortcut | +|---------|-------------|----------| +| `DevBuddy: Refresh Tickets` | Reload ticket list | - | +| `DevBuddy: Create Ticket` | Open ticket creation form | - | +| `DevBuddy: Generate Standup Update` | Generate standup (Linear) | - | +| `DevBuddy: Generate PR Summary` | Generate PR description (Linear) | - | + +### Linear-Specific Commands + +| Command | Description | +|---------|-------------| +| `DevBuddy: Update Linear API Key` | Configure Linear authentication | +| `DevBuddy: Start Branch for Ticket` | Create new branch from Linear ticket | +| `DevBuddy: Associate Branch` | Link existing branch to Linear ticket | +| `DevBuddy: Checkout Branch` | Switch to associated branch | + +### Jira-Specific Commands + +| Command | Description | +|---------|-------------| +| `DevBuddy: Setup Jira Cloud` | Configure Jira Cloud authentication | +| `DevBuddy: Test Jira Connection` | Verify Jira API connection | +| `DevBuddy: Update Jira Issue Status` | Update issue workflow state | +| `DevBuddy: Search Jira Issues` | Search with JQL | +| `DevBuddy: Start Branch for Issue` | Create new branch from Jira issue | +| `DevBuddy: Associate Branch with Issue` | Link existing branch to Jira issue | + +--- + +## Installation + +### From VS Code Marketplace + +Install directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy): + +1. Open VS Code +2. Go to Extensions (Cmd/Ctrl + Shift + X) +3. Search for "DevBuddy" +4. Click Install + +### From GitHub Releases + +Download the latest `.vsix` file from [GitHub Releases](https://github.com/angelo-hub/devbuddy/releases): + +```bash +# Download the latest release from GitHub +# Visit: https://github.com/angelo-hub/devbuddy/releases + +# Install the VSIX file +code --install-extension dev-buddy-x.x.x.vsix +``` + +### From Source + +```bash +# Clone and build +git clone https://github.com/angelo-hub/devbuddy.git +cd devbuddy +npm install +npm run package + +# Install locally +code --install-extension dev-buddy-0.2.0.vsix + +# Quick reinstall script (for development) +./reinstall.sh +``` + +--- + +## Documentation + +Comprehensive guides for all features: + +### User Guides +- [Quick Start Guide](./docs/user-guides/QUICKSTART.md) - Get up and running in 5 minutes +- [Complete Linear Guide](./docs/user-guides/LINEAR_BUDDY_GUIDE.md) - Full Linear feature documentation +- [Multi-Ticket Workflows](./docs/user-guides/MULTI_TICKET_GUIDE.md) - Work across multiple tickets +- [Jira Cloud Guide](./JIRA_QUICK_START.md) - Jira setup and features + +### Feature Documentation +- [AI Features Guide](./docs/features/ai/) - AI configuration and model selection +- [Privacy Mode](./docs/features/ai/) - Rule-based analysis without external AI +- [TODO Converter](./docs/features/todo-converter/) - Complete TODO workflow guide +- [PR & Standup Features](./docs/features/pr-standup/) - PR summaries and standup generation +- [Branch Management](./docs/features/branches/) - Branch creation and association + +### Platform Comparison +- [Feature Compatibility Matrix](./FEATURE_COMPATIBILITY_MATRIX.md) - Detailed platform comparison +- [Jira Cloud vs Server](./JIRA_CLOUD_VS_SERVER.md) - Jira deployment options + +### Developer Resources +- [Development Setup](./docs/developer/DEV_ENVIRONMENT_SETUP.md) - Contributing guide +- [Architecture Guide](./AGENTS.md) - Extension architecture +- [Release Process](./docs/developer/RELEASE_PROCESS.md) - Publishing workflow + +--- + +## What's New in v0.2.0 + +### Multi-Platform Architecture +- Support for Linear AND Jira Cloud +- Easy platform switching via settings +- Unified sidebar interface + +### Jira Cloud Feature Parity +- **Full CRUD operations** - Complete issue management in VS Code +- **Webview panels** - Rich ticket detail and creation forms +- **Branch integration** - Create and associate branches with issues +- **AI features** - PR summaries and standup generation +- **TODO converter** - Convert TODOs to Jira issues with permalinks +- **JQL search** - Advanced filtering and search +- **Workflow transitions** - Full status management +- **Sprint and board management** - Agile workflows +- **Production-grade validation** - Runtime safety with Zod v4 + +### AI & Chat Enhancements +- Chat participant with `@devbuddy` +- Enhanced AI with code diff analysis +- Privacy-first fallback mode + +### Quality Improvements +- Runtime validation with Zod +- Better error handling +- Type-safe throughout +- Debug mode for troubleshooting + +--- + +## Roadmap + +### Short-Term +- ⏳ Jira Cloud chat participant (@devbuddy integration) +- ⏳ Enhanced keyboard shortcuts +- ⏳ Improved offline support + +### Medium-Term +- 🚧 Jira Server/Data Center (beta) - Currently in testing +- ⏳ Custom fields UI +- ⏳ Offline mode +- ⏳ Advanced keyboard shortcuts + +### Long-Term +- ⏳ Monday.com integration +- ⏳ ClickUp integration +- ⏳ GitHub/GitLab Issues support +- ⏳ Team collaboration features + +--- + +## License + +**Dual License:** +- **Core Features:** [MIT License](./LICENSE) - Free and open source +- **Pro Features:** [Commercial License](./LICENSE.pro) - Requires subscription + +The extension is free to use with all core features. Pro features (when available) will require a paid subscription. See [LICENSING_MODEL.md](./LICENSING_MODEL.md) for details. + +--- + +## Support & Contributing + +### Get Help +- [GitHub Issues](https://github.com/angelo-hub/devbuddy/issues) - Report bugs or request features +- [Documentation](./DOCUMENTATION.md) - Complete documentation index +- [Quick Reference](./docs/user-guides/HELP_QUICK_REFERENCE.md) - Common tasks + +### Contributing +We welcome contributions! See our [contributing guide](./docs/developer/DEV_ENVIRONMENT_SETUP.md) for: +- Development setup +- Code style guidelines +- Testing requirements +- Pull request process + +### For Contributors +- [Release Process](./docs/developer/RELEASE_PROCESS.md) - Publishing workflow +- [Architecture Guide](./AGENTS.md) - Extension structure +- [Debug Guide](./docs/developer/DEBUG_QUICK_START.md) - Debugging tips + +--- + +**Platforms:** Linear (Full) | Jira Cloud (Full) | Jira Server (Beta) | More Coming Soon diff --git a/README.md b/README.md index 1094ed0..a2d181e 100644 --- a/README.md +++ b/README.md @@ -1,611 +1,156 @@ -# DevBuddy - Multi-Platform Ticket Management for Developers +# DevBuddy for VS Code +### Unified ticket management for Linear and Jira — directly inside VS Code -[![Version](https://img.shields.io/github/v/release/angelo-hub/devbuddy?label=version)](https://github.com/angelo-hub/devbuddy/releases) -[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) -[![Downloads](https://img.shields.io/visual-studio-marketplace/d/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) -[![License](https://img.shields.io/badge/license-MIT%20%2B%20Pro-blue)](./LICENSE) +[![Version](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![Installs](https://img.shields.io/visual-studio-marketplace/i/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![Rating](https://img.shields.io/visual-studio-marketplace/stars/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) -**Transform your development workflow with AI-powered ticket management, supporting Linear, Jira, and more.** +## Work Faster with Your Issues Inside VS Code -> **Privacy-First:** Works with or without AI. Organizations with strict security policies can disable external AI and use intelligent rule-based analysis instead. +DevBuddy brings your tickets into a single sidebar so you can browse, create, update, and work on issues without switching to the browser. ---- +![DevBuddy Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/start_ticket_branch.gif) -## At a Glance +## Key Features | Feature | Description | Platforms | |---------|-------------|-----------| -| **Sidebar Management** | View and manage all tickets from VS Code | Linear, Jira | -| **AI Workflows** | Generate PR summaries and standups automatically | Linear, Jira | -| **TODO Converter** | Convert TODOs to tickets with automatic code permalinks | Linear, Jira | -| **Chat Participant** | Ask `@devbuddy` questions in natural language | Linear (Jira soon) | -| **Branch Integration** | Create and manage branches directly from tickets | Linear, Jira | +| **Unified Issue Explorer** | View and manage all tickets from VS Code | Linear, Jira Cloud, Jira Server (beta) | +| **TODO Converter** | Convert TODOs to tickets with automatic code permalinks | Linear, Jira Cloud | +| **AI Workflows** | Generate PR summaries and standups automatically | Linear, Jira Cloud | +| **Branch Integration** | Create and manage branches directly from tickets | Linear, Jira Cloud | +| **Chat Participant** | Ask `@devbuddy` questions in natural language | Linear | | **Monorepo Support** | Intelligent package detection and validation | All platforms | ---- - -## Supported Platforms - -| Platform | Status | Features | -|----------|--------|----------| -| **Linear** | ✅ Full Support | Complete feature set with AI integration | -| **Jira Cloud** | ✅ Full Support | Feature parity with Linear - AI, branches, webviews | -| **Jira Server (beta)** | 🚧 Beta | Self-hosted Jira support - testing phase | -| **Monday.com** | ⏳ Planned | Future release | -| **ClickUp** | ⏳ Planned | Future release | - ---- - -## Why DevBuddy? - -Stop context switching. Manage tickets, generate documentation, and track work without leaving VS Code. - -| Task | Manual Workflow | With DevBuddy | Time Saved | -|------|----------------|---------------|------------| -| **Create ticket from TODO** | Open browser, create ticket, copy ID, paste in code, add permalink manually | Right-click → Convert TODO | 5 min → 10 sec | -| **Track TODOs across files** | Create ticket, manually update 4 files with ticket ID | Create once → paste in 3 more locations | 10 min → 30 sec | -| **Generate PR summary** | Review changes, write description, list affected packages | One command → AI generates full summary | 15 min → 1 min | -| **Daily standup** | Review commits, check tickets, write update | One click → AI generates standup | 10 min → 30 sec | -| **Update ticket status** | Open browser, find ticket, update status | Right-click in sidebar → select new status | 1 min → 5 sec | - ---- - ## Quick Start -### 1. Install Extension - -**From VS Code Marketplace:** -1. Open VS Code -2. Go to Extensions (Cmd/Ctrl + Shift + X) -3. Search for "DevBuddy" -4. Click Install - -**Or install from command line:** -```bash -code --install-extension angelogirardi.dev-buddy -``` +1. **Install DevBuddy** from the VS Code Marketplace +2. **Open the DevBuddy sidebar** (click the checklist icon) +3. **Connect your platform:** + - Linear: `DevBuddy: Update Linear API Key` + - Jira Cloud: `DevBuddy: Setup Jira Cloud` +4. **Start managing issues** directly inside VS Code -### 2. Choose Your Platform +Full documentation: [DevBuddy Quick Start Guide](https://github.com/angelo-hub/devbuddy/blob/main/docs/user-guides/QUICKSTART.md) -Open Settings and set your preferred platform: +## Example Workflows -```json -{ - "devBuddy.provider": "linear" // or "jira" -} -``` - -| Setting Value | Platform | Configuration Required | -|---------------|----------|------------------------| -| `"linear"` | Linear | API token from linear.app/settings/api | -| `"jira"` | Jira Cloud | Site URL, email, API token | - -### 3. Configure Authentication - -
-For Linear Users - -1. Get your API key: [linear.app/settings/api](https://linear.app/settings/api) -2. Open Command Palette: `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) -3. Run: `DevBuddy: Update Linear API Key` -4. Paste your API token - -**Optional Configuration:** -```json -{ - "devBuddy.linear.organization": "yourorg", - "devBuddy.linear.teamId": "team-id-here" -} -``` - -
- -
-For Jira Cloud Users - -1. Open Command Palette: `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux) -2. Run: `DevBuddy: Setup Jira Cloud` -3. Enter your Jira site URL (e.g., `yourcompany.atlassian.net`) -4. Enter your email address -5. Create an API token: [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) -6. Paste the API token when prompted - -**Tip:** You can paste any Jira ticket URL and DevBuddy will extract your site URL automatically. - -
- -### 4. Start Using DevBuddy - -Three ways to interact with DevBuddy: - -1. **Sidebar:** Click the checklist icon in the Activity Bar -2. **Chat:** Open VS Code Chat → type `@devbuddy` -3. **Commands:** Press `Cmd+Shift+P` → search "DevBuddy" - ---- - -## Core Features - -### Universal Ticket Management - -Works across all supported platforms with a consistent interface. - -**Sidebar Features:** -- View all assigned tickets/issues organized by status -- Quick actions: Update status, assign, comment -- Filter by status, project, priority -- Visual priority indicators -- One-click to open ticket details - -![Sidebar Demo - Placeholder](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/sidebar-demo.gif) - -**Key Benefits:** -- Single interface for multiple platforms -- Real-time synchronization -- Keyboard shortcuts for common actions -- Inline actions without opening browser - ---- - -### TODO to Ticket Converter - -Transform TODO comments into fully-tracked tickets with automatic code permalinks. Works with both Linear and Jira Cloud. +### Convert TODO → Ticket ![TODO Converter Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/todo-converter-demo.gif) -**How it works:** -1. Write a TODO comment in your code -2. Right-click → "Convert TODO to Ticket" -3. Review auto-generated ticket with permalink -4. Choose: Replace TODO, Add More TODOs, or Link Existing TODOs -5. Works seamlessly with Linear or Jira Cloud - -**What gets included automatically:** -- File path and line number -- GitHub/GitLab/Bitbucket permalink to exact code location -- 5 lines of surrounding code context -- Current branch and commit SHA -- Syntax highlighting in Linear - -**Multi-File Workflow:** - -![Add More TODOs Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/add-more-todos.gif) - -After creating a ticket, use "Add More TODOs" to: -- Navigate to multiple files with Quick Open (Cmd+P) -- Paste ticket reference in each location -- Track complex refactors across your codebase -- Keep all TODOs linked to the same ticket - -**Key Benefits:** -- Zero context loss for your team -- Permanent links that survive refactoring -- 10x faster than manual ticket creation -- Works with GitHub, GitLab, and Bitbucket - -[Learn more about TODO Converter](./docs/features/todo-converter/) - ---- - -### AI-Powered PR Summaries - -Generate comprehensive pull request descriptions automatically, with special support for monorepos. Works with both Linear and Jira Cloud. - -![PR Summary Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/pr-summary-demo.gif) - -**Monorepo Intelligence:** -- Automatically detects affected packages -- Analyzes changes per package separately -- Shows scope of your changes -- Warns if too many packages are modified - -**What gets generated:** -- High-level overview of changes -- Per-package breakdown in monorepos -- Testing notes and checklist -- Linked tickets (Linear or Jira) -- Breaking changes detection -- Migration notes if needed - -**PR Template Integration:** -- Reads your `.github/pull_request_template.md` -- Fills in sections automatically -- Preserves formatting and checkboxes -- Keeps custom fields and instructions - -**Key Benefits:** -- Works with monorepos out of the box -- Customizable writing tone (professional, casual, technical, concise) -- Includes git diff analysis -- Ready to paste into GitHub/GitLab - -[Learn more about PR Summaries](./docs/features/pr-standup/) - ---- - -### AI Standup Generator +Write a TODO comment, right-click → "Convert TODO to Ticket". DevBuddy automatically: +- Creates a ticket with file path and line number +- Generates GitHub/GitLab/Bitbucket permalink to exact code location +- Includes 5 lines of surrounding code context +- Links to current branch and commit SHA -Let AI generate your standup update automatically from commits and ticket activity. Works with both Linear and Jira Cloud. +### Create a Branch from an Issue -![Standup Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/standup-demo.gif) +![Branch Creation Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/start_ticket_branch.gif) -**How it works:** -1. Open Standup Builder -2. Review your recent commits and Linear tickets -3. Click "Generate with AI" -4. Get formatted standup with Yesterday/Today/Blockers -5. Copy and share +Right-click any ticket → "Start Branch for Ticket". DevBuddy creates a branch with smart naming (conventional, simple, or custom) and automatically associates it with the ticket. -**What gets analyzed:** -- Git commits in configurable time window (default: 24 hours) -- Tickets you've updated (Linear or Jira) -- Code changes across packages -- Commit message context -- Branch associations +### Edit Tickets Directly in VS Code -**Customization:** -- Adjust time window (24 hours, 2 days, since last standup) -- Choose writing tone (professional, casual, technical, concise) -- Select AI model preference -- Edit generated content before sharing +![Edit Ticket Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/edit_ticket.gif) -**Key Benefits:** -- Never forget what you worked on -- Consistent standup format -- Takes 30 seconds instead of 10 minutes -- Automatically links to relevant tickets +Click any ticket to view full details, update status, add comments, and manage all ticket properties without leaving your editor. -[Learn more about Standup Builder](./docs/features/pr-standup/) +### AI-Powered Standup Generator ---- - -### Chat Participant - -Talk to DevBuddy using the VS Code Chat interface. - -**Available Commands:** -- `/tickets` - Show your current tickets -- `/standup` - Generate standup update (Linear) -- `/pr` - Generate PR summary (Linear) -- `/status` - Update ticket status - -**Natural Language Queries:** -``` -@devbuddy what am I working on? -@devbuddy show me ENG-123 (Linear) or PROJ-456 (Jira) -@devbuddy create a ticket for authentication bug -@devbuddy update ENG-456 to in progress -@devbuddy generate my standup -@devbuddy generate PR summary -``` - -**Key Benefits:** -- Works with both Linear and Jira -- Natural conversation about your work -- Quick access to ticket information -- No need to remember command names - ---- - -## Platform-Specific Features - -### Linear Features - -Linear users get the complete DevBuddy experience with full feature support. - -| Feature | Status | Description | -|---------|--------|-------------| -| View Tickets | ✅ | Rich sidebar with webview panels | -| Create/Edit Tickets | ✅ | Full ticket management interface | -| Status Management | ✅ | Visual workflow with all states | -| Branch Creation | ✅ | Create and manage branches from tickets | -| Branch Association | ✅ | Link existing branches to tickets | -| TODO Converter | ✅ | Convert TODOs with automatic permalinks | -| AI Standup | ✅ | Generate standup from commits and tickets | -| AI PR Summary | ✅ | Generate PR descriptions with monorepo support | -| Chat Participant | ✅ | Full chat integration with all commands | -| Comments | ✅ | Read and add comments to tickets | -| Sub-issues | ✅ | View and manage sub-issues | - -**Branch Integration:** - -![Linear Branch Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/linear-sidebar-demo.gif) - -- Create branches with smart naming (conventional, simple, or custom) -- Auto-detect associations based on branch names -- Checkout associated branches from sidebar -- View linked PRs directly in ticket panel - -### Jira Cloud Features - -Jira Cloud users get the complete DevBuddy experience with full feature parity to Linear. - -| Feature | Status | Description | -|---------|--------|-------------| -| View Issues | ✅ | Rich sidebar with webview panels | -| Create/Edit Issues | ✅ | Full issue management interface in VS Code | -| Status Transitions | ✅ | Full workflow transition support | -| Branch Creation | ✅ | Create and manage branches from issues | -| Branch Association | ✅ | Link existing branches to issues | -| TODO Converter | ✅ | Convert TODOs with automatic code permalinks | -| AI Standup | ✅ | Generate standup from commits and Jira activity | -| AI PR Summary | ✅ | Generate PR descriptions with monorepo support | -| JQL Search | ✅ | Advanced search with Jira Query Language | -| Comments | ✅ | Read and add comments | -| Sprints & Boards | ✅ | View and manage sprints | -| Runtime Validation | ✅ | Production-grade API validation with Zod v4 | -| Chat Participant | ⏳ | Coming soon | -| Sub-tasks | ✅ | View and manage sub-tasks | -| Attachments | ✅ | View and download attachments | - -**Full Feature Set:** - -![Jira Sidebar Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/jira-sidebar-demo.gif) - -- **Manage issues** directly in VS Code without browser context switching -- **View and edit** issues with rich webview panels -- **Create branches** with smart naming (conventional, simple, or custom) -- **Auto-detect associations** based on branch names -- **Generate standups** from Jira activity and git commits -- **AI-powered PR summaries** with monorepo intelligence -- **Convert TODOs to tickets** with automatic code permalinks -- **Update status** with workflow transitions -- **Quick actions**: Add comment, assign, copy issue key -- **JQL search** for advanced filtering -- **Sprint management** and agile workflows - ---- - -## AI Configuration - -### Privacy-First AI Options - -DevBuddy gives you complete control over AI usage. - -**Option 1: Use AI (Default)** - -Leverage VS Code's Language Model API (GitHub Copilot) for intelligent summaries. - -**Supported Models:** -- GPT-4o (recommended) -- GPT-4.1 -- GPT-4 Turbo -- Gemini 2.0 Flash - -**Configuration:** -```json -{ - "devBuddy.ai.model": "auto", // Auto-selects best available - "devBuddy.writingTone": "professional" // or casual, technical, concise -} -``` - -**Option 2: Privacy Mode (No External AI)** - -Perfect for regulated industries or strict security policies. - -```json -{ - "devBuddy.ai.disabled": true -} -``` - -DevBuddy will use intelligent rule-based analysis instead: -- Pattern detection in commits -- Commit message analysis -- File change categorization -- 100% local processing -- Works offline - ---- - -## Monorepo Support - -DevBuddy is built for monorepos with intelligent package detection. - -**Configuration:** -```json -{ - "devBuddy.packagesPaths": ["packages/", "apps/", "libs/"], - "devBuddy.maxPackageScope": 2, // Warn if > 2 packages modified - "devBuddy.baseBranch": "main" -} -``` - -**Features:** -- Automatic package detection -- Per-package change analysis in PR summaries -- Scope validation and warnings -- Package-aware commit analysis -- Multi-package workflow support - ---- +![Standup Builder Demo](https://raw.githubusercontent.com/angelo-hub/devbuddy/main/media/walkthrough/videos/standup_builder.gif) -## Commands Reference +Run `DevBuddy: Generate Standup Update` to automatically generate standup reports from your commits and ticket activity with: +- Yesterday's completed work +- Today's planned tasks +- Blockers and dependencies +- Automatic ticket linking -### Universal Commands - -Work with any configured platform: - -| Command | Description | Shortcut | -|---------|-------------|----------| -| `DevBuddy: Refresh Tickets` | Reload ticket list | - | -| `DevBuddy: Create Ticket` | Open ticket creation form | - | -| `DevBuddy: Generate Standup Update` | Generate standup (Linear) | - | -| `DevBuddy: Generate PR Summary` | Generate PR description (Linear) | - | - -### Linear-Specific Commands - -| Command | Description | -|---------|-------------| -| `DevBuddy: Update Linear API Key` | Configure Linear authentication | -| `DevBuddy: Start Branch for Ticket` | Create new branch from Linear ticket | -| `DevBuddy: Associate Branch` | Link existing branch to Linear ticket | -| `DevBuddy: Checkout Branch` | Switch to associated branch | - -### Jira-Specific Commands +## Supported Platforms -| Command | Description | -|---------|-------------| -| `DevBuddy: Setup Jira Cloud` | Configure Jira Cloud authentication | -| `DevBuddy: Test Jira Connection` | Verify Jira API connection | -| `DevBuddy: Update Jira Issue Status` | Update issue workflow state | -| `DevBuddy: Search Jira Issues` | Search with JQL | -| `DevBuddy: Start Branch for Issue` | Create new branch from Jira issue | -| `DevBuddy: Associate Branch with Issue` | Link existing branch to Jira issue | +### Fully Supported +- **Linear** - Complete feature set with AI integration +- **Jira Cloud** - Full feature parity with Linear ---- +### In Beta +- **Jira Server / Data Center** - Read-only support (editing coming soon) -## Installation +## Optional AI Enhancements -### From VS Code Marketplace +Connect GitHub Copilot or another LLM provider to unlock: +- Pull request summaries +- Standup reports +- Ticket drafts with descriptions and acceptance criteria -Install directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy): +**AI features are optional** — DevBuddy works fully without them using intelligent rule-based analysis. -1. Open VS Code -2. Go to Extensions (Cmd/Ctrl + Shift + X) -3. Search for "DevBuddy" -4. Click Install +## Privacy and Security -### From GitHub Releases +- ✅ All credentials stored using VS Code Secret Storage +- ✅ No telemetry collected +- ✅ DevBuddy doesn't run servers or proxy your data +- ✅ Only Jira/Linear APIs you configure are contacted +- ✅ Privacy-first: AI is completely optional -Download the latest `.vsix` file from [GitHub Releases](https://github.com/angelo-hub/devbuddy/releases): +## What's New in v0.5.0 -```bash -# Download the latest release from GitHub -# Visit: https://github.com/angelo-hub/devbuddy/releases +- **Jira Server/Data Center Support (Beta)** - Connect to self-hosted Jira instances +- **Enhanced TODO Converter** - Better permalink generation and multi-file workflows +- **Improved AI Models** - Support for GPT-4o, GPT-4.1, and Gemini 2.0 Flash +- **Better Error Handling** - Clearer error messages and debugging support +- **Runtime Validation** - Production-grade API validation with Zod v4 -# Install the VSIX file -code --install-extension dev-buddy-x.x.x.vsix -``` +## Commands Overview -### From Source +### Universal Commands (All Platforms) +- `DevBuddy: Refresh Tickets` - Reload ticket list +- `DevBuddy: Create Ticket` - Open ticket creation form +- `DevBuddy: Generate PR Summary` - Generate PR description +- `DevBuddy: Generate Standup Update` - Generate standup report -```bash -# Clone and build -git clone https://github.com/angelo-hub/devbuddy.git -cd devbuddy -npm install -npm run package +### Platform-Specific Setup +- `DevBuddy: Update Linear API Key` - Configure Linear +- `DevBuddy: Setup Jira Cloud` - Configure Jira Cloud +- `DevBuddy: Setup Jira Server` - Configure Jira Server/Data Center -# Install locally -code --install-extension dev-buddy-0.2.0.vsix +## Roadmap -# Quick reinstall script (for development) -./reinstall.sh -``` +- ✅ Linear - Full support +- ✅ Jira Cloud - Full support +- 🚧 Jira Server/Data Center - Beta (editing coming soon) +- ⏳ GitHub Issues integration +- ⏳ YouTrack support +- ⏳ Monday.com integration +- ⏳ Enhanced multi-account workflows ---- +Track updates: [GitHub Repository](https://github.com/angelo-hub/devbuddy) ## Documentation -Comprehensive guides for all features: +- [Quick Start Guide](https://github.com/angelo-hub/devbuddy/blob/main/docs/user-guides/QUICKSTART.md) +- [Complete Linear Guide](https://github.com/angelo-hub/devbuddy/blob/main/docs/user-guides/LINEAR_BUDDY_GUIDE.md) +- [Jira Cloud Setup](https://github.com/angelo-hub/devbuddy/blob/main/JIRA_QUICK_START.md) +- [Feature Compatibility Matrix](https://github.com/angelo-hub/devbuddy/blob/main/FEATURE_COMPATIBILITY_MATRIX.md) +- [Developer Guide](https://github.com/angelo-hub/devbuddy/blob/main/DEVELOPER_GUIDE.md) - Contributing & development +- [Full Documentation](https://github.com/angelo-hub/devbuddy) -### User Guides -- [Quick Start Guide](./docs/user-guides/QUICKSTART.md) - Get up and running in 5 minutes -- [Complete Linear Guide](./docs/user-guides/LINEAR_BUDDY_GUIDE.md) - Full Linear feature documentation -- [Multi-Ticket Workflows](./docs/user-guides/MULTI_TICKET_GUIDE.md) - Work across multiple tickets -- [Jira Cloud Guide](./JIRA_QUICK_START.md) - Jira setup and features +## Support -### Feature Documentation -- [AI Features Guide](./docs/features/ai/) - AI configuration and model selection -- [Privacy Mode](./docs/features/ai/) - Rule-based analysis without external AI -- [TODO Converter](./docs/features/todo-converter/) - Complete TODO workflow guide -- [PR & Standup Features](./docs/features/pr-standup/) - PR summaries and standup generation -- [Branch Management](./docs/features/branches/) - Branch creation and association +**Documentation:** [github.com/angelo-hub/devbuddy](https://github.com/angelo-hub/devbuddy) +**Issues & Feature Requests:** [GitHub Issues](https://github.com/angelo-hub/devbuddy/issues) -### Platform Comparison -- [Feature Compatibility Matrix](./FEATURE_COMPATIBILITY_MATRIX.md) - Detailed platform comparison -- [Jira Cloud vs Server](./JIRA_CLOUD_VS_SERVER.md) - Jira deployment options - -### Developer Resources -- [Development Setup](./docs/developer/DEV_ENVIRONMENT_SETUP.md) - Contributing guide -- [Architecture Guide](./AGENTS.md) - Extension architecture -- [Release Process](./docs/developer/RELEASE_PROCESS.md) - Publishing workflow - ---- - -## What's New in v0.2.0 - -### Multi-Platform Architecture -- Support for Linear AND Jira Cloud -- Easy platform switching via settings -- Unified sidebar interface - -### Jira Cloud Feature Parity -- **Full CRUD operations** - Complete issue management in VS Code -- **Webview panels** - Rich ticket detail and creation forms -- **Branch integration** - Create and associate branches with issues -- **AI features** - PR summaries and standup generation -- **TODO converter** - Convert TODOs to Jira issues with permalinks -- **JQL search** - Advanced filtering and search -- **Workflow transitions** - Full status management -- **Sprint and board management** - Agile workflows -- **Production-grade validation** - Runtime safety with Zod v4 - -### AI & Chat Enhancements -- Chat participant with `@devbuddy` -- Enhanced AI with code diff analysis -- Privacy-first fallback mode - -### Quality Improvements -- Runtime validation with Zod -- Better error handling -- Type-safe throughout -- Debug mode for troubleshooting - ---- - -## Roadmap - -### Short-Term -- ⏳ Jira Cloud chat participant (@devbuddy integration) -- ⏳ Enhanced keyboard shortcuts -- ⏳ Improved offline support - -### Medium-Term -- 🚧 Jira Server/Data Center (beta) - Currently in testing -- ⏳ Custom fields UI -- ⏳ Offline mode -- ⏳ Advanced keyboard shortcuts - -### Long-Term -- ⏳ Monday.com integration -- ⏳ ClickUp integration -- ⏳ GitHub/GitLab Issues support -- ⏳ Team collaboration features - ---- +If DevBuddy improves your workflow, please consider leaving a review or starring the repository! ⭐ ## License **Dual License:** -- **Core Features:** [MIT License](./LICENSE) - Free and open source -- **Pro Features:** [Commercial License](./LICENSE.pro) - Requires subscription +- **Core Features:** MIT License - Free and open source +- **Pro Features:** Commercial License (when available) -The extension is free to use with all core features. Pro features (when available) will require a paid subscription. See [LICENSING_MODEL.md](./LICENSING_MODEL.md) for details. +All current features are free to use. Future Pro features will require a subscription. --- -## Support & Contributing - -### Get Help -- [GitHub Issues](https://github.com/angelo-hub/devbuddy/issues) - Report bugs or request features -- [Documentation](./DOCUMENTATION.md) - Complete documentation index -- [Quick Reference](./docs/user-guides/HELP_QUICK_REFERENCE.md) - Common tasks - -### Contributing -We welcome contributions! See our [contributing guide](./docs/developer/DEV_ENVIRONMENT_SETUP.md) for: -- Development setup -- Code style guidelines -- Testing requirements -- Pull request process - -### For Contributors -- [Release Process](./docs/developer/RELEASE_PROCESS.md) - Publishing workflow -- [Architecture Guide](./AGENTS.md) - Extension structure -- [Debug Guide](./docs/developer/DEBUG_QUICK_START.md) - Debugging tips - ---- +**Version 0.5.0** | Made with ❤️ for developers who hate context switching -**Platforms:** Linear (Full) | Jira Cloud (Full) | Jira Server (Beta) | More Coming Soon diff --git a/package.json b/package.json index 464d746..2edd645 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,7 @@ "version": "0.5.0", "publisher": "angelogirardi", "license": "SEE LICENSE IN LICENSE", - "readme": "MARKETPLACE_README.md", + "readme": "README.md", "icon": "resources/icon.png", "author": { "name": "Angelo Girardi", From a283ea24888ae47f0e39c1e16ce526d45c2b7572 Mon Sep 17 00:00:00 2001 From: Angelo Girardi Date: Thu, 20 Nov 2025 17:38:22 -0600 Subject: [PATCH 2/4] fix: add badges --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index a2d181e..ca0bf98 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,10 @@ [![Version](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Installs](https://img.shields.io/visual-studio-marketplace/i/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![Downloads](https://img.shields.io/visual-studio-marketplace/d/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Rating](https://img.shields.io/visual-studio-marketplace/stars/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) +[![GitHub Release](https://img.shields.io/github/v/release/angelo-hub/devbuddy)](https://github.com/angelo-hub/devbuddy/releases) +[![License](https://img.shields.io/badge/license-MIT%20%2B%20Pro-blue)](https://github.com/angelo-hub/devbuddy/blob/main/LICENSE) ## Work Faster with Your Issues Inside VS Code From 6f30897dda71cbf0c3050547a0635564556ef9e7 Mon Sep 17 00:00:00 2001 From: Angelo Girardi Date: Thu, 20 Nov 2025 17:39:12 -0600 Subject: [PATCH 3/4] fix: add badges --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ca0bf98..9b03d16 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,12 @@ # DevBuddy for VS Code ### Unified ticket management for Linear and Jira — directly inside VS Code -[![Version](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) + [![Installs](https://img.shields.io/visual-studio-marketplace/i/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Downloads](https://img.shields.io/visual-studio-marketplace/d/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Rating](https://img.shields.io/visual-studio-marketplace/stars/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![GitHub Release](https://img.shields.io/github/v/release/angelo-hub/devbuddy)](https://github.com/angelo-hub/devbuddy/releases) +[![Version](https://img.shields.io/visual-studio-marketplace/v/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Pro-blue)](https://github.com/angelo-hub/devbuddy/blob/main/LICENSE) ## Work Faster with Your Issues Inside VS Code From 2ebbfd322c8ce2051a6f931fd9c33d06d09b73e3 Mon Sep 17 00:00:00 2001 From: Angelo Girardi Date: Thu, 20 Nov 2025 17:39:34 -0600 Subject: [PATCH 4/4] fix: add badges --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 9b03d16..f10e5c7 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,6 @@ ### Unified ticket management for Linear and Jira — directly inside VS Code -[![Installs](https://img.shields.io/visual-studio-marketplace/i/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Downloads](https://img.shields.io/visual-studio-marketplace/d/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![Rating](https://img.shields.io/visual-studio-marketplace/stars/angelogirardi.dev-buddy)](https://marketplace.visualstudio.com/items?itemName=angelogirardi.dev-buddy) [![GitHub Release](https://img.shields.io/github/v/release/angelo-hub/devbuddy)](https://github.com/angelo-hub/devbuddy/releases)