ghmulti for VS Code
Manage and switch GitHub identities from VS Code using the ghmulti CLI.
Features
- Status bar indicator for the current effective account.
- Quick action menu for:
- Add account
- Switch account
- Link repository to account
- Unlink repository account
- Show status
- Run doctor diagnostics
- Multi-root workspace support with repository picker for link/unlink/status flows.
- Command palette commands:
ghmulti: Open Menu
ghmulti: Add Account
ghmulti: Switch Account
ghmulti: Link Account to Repository
ghmulti: Unlink Repository Account
ghmulti: Show Status
ghmulti: Run Doctor
Requirements
ghmulti CLI installed and available in your environment.
- A configured
ghmulti account set (for switching/linking).
Install CLI from the project root:
pip install -e .
Extension Settings
ghmulti.commandPath
- Optional absolute path to
ghmulti executable.
- Leave empty to use auto-detection (
ghmulti, python -m ghmulti, python3 -m ghmulti, py -m ghmulti).
Usage
- Open a git repository in VS Code.
- Click the ghmulti status bar item.
- Pick an action from the menu.
For repository-specific identity, use Link Repository and Unlink Repository.
Development Testing
From vscode-extension/:
npm install
npm run compile
npm test
Troubleshooting
- Run
ghmulti: Run Doctor and check the ghmulti output channel.
- Run
ghmulti: Show Status to inspect effective/global/link states.
- If CLI detection fails, set
ghmulti.commandPath explicitly.
Publish To VS Code Marketplace
- Create/verify your publisher in Visual Studio Marketplace.
- Create a Personal Access Token with Marketplace publish permissions.
- Login once:
npx @vscode/vsce login nyigoro
- Package locally:
npm run package
- Publish:
npm run publish:vsce
| |