wizgit-vscode-extension/README.md

WizGIT for VS Code

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

Release Notes

0.0.2 (Current)

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! 🪄✨