GitSpectre

GitSpectre is an AI-powered Git assistant for VS Code. It helps you run Git operations using natural language from commands or the sidebar.

Features

• Analyze the current repository state
• Ask Git questions in plain language
• Run natural-language Git commands
• Use either OpenRouter or Anthropic providers
• Launch from command palette, keybindings, or sidebar

Requirements

• VS Code 1.109.0 or newer
• A valid AI provider API key:
  • OpenRouter API key, or
  • Anthropic API key

Extension Settings

GitSpectre contributes the following settings:

• gitspectre.provider: AI provider (openrouter or anthropic)
• gitspectre.apiKey: OpenRouter API key
• gitspectre.anthropicApiKey: Anthropic API key
• gitspectre.model: Optional custom model name
• gitspectre.autoActivate: Auto-enable in Git workspaces
• gitspectre.verbose: Enable verbose logs

Development

npm install
npm run compile

Package extension locally:

npm run release:check

Publishing

VS Code Marketplace

1. Create a publisher in the VS Code Marketplace.
2. Create a Personal Access Token (PAT).
3. Login once:

npx vsce login <publisher-id>

4. Publish:

npm run publish:extension

Automated publishing is also configured in GitHub Actions (see docs/release/DEPLOYMENT.md).

CLI Package Manager Distribution

Release playbooks for npm, Homebrew, Winget, and Linux options are documented in docs/release/DEPLOYMENT.md.

Known Issues

• API provider limits can cause temporary response failures.
• Very large repositories may produce slower analysis responses.

License

MIT