GitBucket Repos

GitBucket Repos is a VS Code extension for browsing GitBucket repositories and branches from a dedicated activity bar view.

Features

• Connect to a GitBucket server with username and password prompts inside VS Code.
• Connect with either username/password or a personal access token.
• Store the GitBucket server URL and credentials in VS Code SecretStorage.
• Browse repositories visible to the authenticated user.
• Expand any repository to view its branches.
• Create personal repositories from the GitBucket view.
• Create repositories under your personal account or one of your GitBucket organizations.
• Create new branches from any repository or existing branch.
• Browse issues and pull requests from dedicated GitBucket side bar views.
• Open repositories or branches in the browser.
• Open issues and pull requests in the browser.
• Copy clone URLs or trigger cloning through VS Code's built-in Git extension when available.

Requirements

• A reachable GitBucket server that exposes the GitHub-compatible REST API under /api/v3.
• Credentials that can read the repositories you want to browse.

Extension Settings

This extension contributes the following setting:

• gitbucketRepos.baseUrl: Default GitBucket server URL shown in the connect prompt.
• gitbucketRepos.preferredAuthMode: Preferred auth mode for GitBucket connections.

Usage

1. Open the GitBucket view from the activity bar.
2. Run GitBucket: Connect.
3. Choose username/password or personal access token authentication.
4. Enter the server URL and credentials.
5. Expand repositories to inspect branches.
6. Use the Repositories view title actions to create repositories under your account or an organization.
7. Use the repository and branch context menus to create branches, open a repository, open a branch, copy a clone URL, or start a clone.
8. Use the Issues and Pull Requests views to inspect repository activity and open items in the browser.

Packaging

• Run npm run package:vsix to build an installable VSIX package.

Known Issues

• Pull requests, issues, and branch protection management are not implemented yet.

Issue and pull request views currently ask you to pick a repository each refresh instead of tracking selection from the repository tree.

Release Notes

0.0.1

Initial GitBucket repository and branch explorer with secure credential storage, token auth, organization-aware repository creation, and issue and pull request browser views.