wizgit-vscode-extension/README.md

# WizGIT for VS Code

![Visual Studio Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/terencecarrera.wizgit-in-vscode?style=for-the-badge&label=Marketplace)
![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)

Your intelligent coding companion for comprehensive repository management, right inside Visual Studio Code. WizGIT provides seamless integration with your WizGit for repositories, issues, and pull requests.

## Features

### 🏠 **Dedicated Activity Bar**

* **Custom WizGIT sidebar** with organized views for repositories, issues, and pull requests
* **Quick access** to all WizGIT functionality from the activity bar

### 📁 **Repository Management**

* **Create repositories:** Easily create new repositories on WizGit directly from VS Code
* **Clone repositories:** Clone existing repositories with integrated UI
* **Repository discovery:** Automatic workspace detection and repository listing
* **Refresh functionality:** Keep your repository list up-to-date

### 🐛 **Issue Management** 

* **Create issues:** Create new issues with intelligent workspace auto-detection
* **Repository auto-detection:** Automatically populate organization and repository from your workspace
* **Branch selection:** Choose target branch from a list of available branches (local and remote)
* **Context integration:** Create issues from file explorer or editor context menu

### 🔀 **Pull Request Management**

* **Create pull requests:** Create PRs with comprehensive file change detection
* **File changes display:** View detailed file modifications and diffs
* **Smart branch selection:** Choose source and destination branches with intelligent defaults
* **Workspace integration:** Auto-detect repository information from your current workspace

### 🔐 **Authentication & Security**

* **Secure token storage:** Safely store and manage your WizGit Personal Access Token
* **Configuration management:** Easy setup and configuration clearing options
* **API endpoint flexibility:** Support for custom WizGit/Gitea instances

### ⚙️ **Smart Features**

* **Workspace detection:** Automatically identify Git repositories and extract owner/repo information
* **Branch enumeration:** List and select from available local and remote branches  
* **Progress tracking:** Visual progress indication during operations
* **Error handling:** Comprehensive error reporting and troubleshooting

## Requirements

* Visual Studio Code v1.74.0 or newer.
* A valid WizGit account with API access.
* Personal Access Token from your WizGit instance.

## Getting Started

### Initial Setup

1. **Configure WizGIT:** Open Command Palette (`Ctrl+Shift+P`) and run `WizGIT: Configure WizGIT`
2. **Enter your details:**
   - WizGit API endpoint (e.g., `https://your-wizgit-instance.com/api/v1`)
   - Personal Access Token from your WizGit instance
3. **Access the sidebar:** Click the WizGIT icon in the activity bar to open the dedicated sidebar

### Creating Repositories

1. In the WizGIT sidebar, go to the **Repositories** view
2. Click the "Create Repository" button (➕) in the title bar
3. Fill in repository details and click "Create Repository"

### Managing Issues  

1. In the **Issues** view, click "Create Issue" (🐛)
2. The extension will automatically detect your workspace repository
3. Choose the target branch from the dropdown list
4. Fill in issue title and description, then submit

### Creating Pull Requests

1. In the **Pull Requests** view, click "Create Pull Request" (🔀)
2. Select source and destination branches
3. Review the automatically detected file changes
4. Add title and description, then create the PR

### Alternative Access Methods

- **Command Palette:** All commands are available via `Ctrl+Shift+P` 
- **Context Menus:** Right-click in file explorer or editor to create issues
- **Keyboard Shortcuts:** Assign custom shortcuts to frequently used commands

## Commands

### Repository Commands

* `WizGIT: Configure WizGIT` - Set up API endpoint and authentication
* `WizGIT: Create Repository` - Create a new repository
* `WizGIT: Clone Repository` - Clone an existing repository
* `WizGIT: Clear Configuration` - Remove stored authentication data

### Issue & PR Commands  

* `WizGIT: Create Issue` - Create a new issue with workspace auto-detection
* `WizGIT: Create Pull Request` - Create a pull request with file change detection

## Extension Settings

This extension contributes the following settings:

* `wizgit.apiEndpoint` - Your WizGIT API endpoint URL
* `wizgit.autoDetect` - Automatically detect WizGIT repositories in workspace (default: `true`)
* `wizgit.statusBar.enabled` - Show WizGIT information in status bar (default: `true`)  
* `wizgit.notifications.enabled` - Enable WizGIT notifications (default: `true`)
* `wizgit.defaultBranch` - Default branch name for new repositories (default: `master`)

You can access these settings through VS Code's Settings UI or by adding them to your `settings.json`.

## Known Issues

* Network connectivity issues may cause API operations to fail
* File change detection for pull requests may not work with all repository configurations
* Workspace auto-detection requires a valid Git repository with remote origin configured
* Please report any bugs or feature requests on our [Issues page](http://126.209.24.132/terence.carrera/wizgit-vscode-extension/issues)

## Release Notes

### 0.0.4 (Current)

* Bump version to 0.0.4
* Fix issue with branch selection dropdown not populating correctly in some cases
* Improve error messages for API failures during issue and pull request creation
* Optimize repository detection logic for workspaces with multiple Git repositories
* Enhance UI responsiveness during long-running operations with better progress indicators

### 0.0.3

* Bump version to 0.0.3

### 0.0.2

Major feature expansion and UI improvements:

* **New dedicated activity bar** with custom WizGIT sidebar
* **Issue management** with workspace auto-detection and branch selection
* **Pull request creation** with file change detection and diff display
* **Repository cloning** functionality
* **Workspace integration** - automatic repository detection from Git remotes
* **Branch enumeration** - list and select from local/remote branches
* **Context menu integration** - create issues from explorer and editor
* **Enhanced configuration** - comprehensive settings and token management
* **Improved error handling** and user experience
* **Custom branding** with WizGIT logo and theming

### 0.0.1

Initial release of WizGIT:

* Core repository creation via WizGit API
* Basic authentication and configuration
* Progress tracking and error handling

---

**Enjoy comprehensive repository management with WizGIT! 🪄✨**