AH Git Manager

English | فارسی

AI-assisted, strictly command-based Git workflow manager for VS Code — with a multi-provider AI engine, a chat-style sidebar, and 31 Git commands covering status, history, branches, code review, auto-commit, and evidence-based Git intelligence.

Powered by AH Team — https://ahmdhasanzadeh.com

What it does

• Understands 31 slash commands (/status, /diff, /ask, …) executed against your real repository. Unknown input is rejected locally and never sent anywhere.
• Talks to 10 AI providers (OpenAI, Anthropic Claude, Google Gemini, OpenRouter, DeepSeek, Mistral, Azure OpenAI, Ollama, LM Studio, or any custom OpenAI-compatible endpoint), each through its native wire protocol.
• Generates Conventional Commit messages, reviews diffs, explains history, analyzes branches, drafts PRs — and can stage + commit with your explicit confirmation (never pushes on its own).
• Answers plain-words questions (/ask where did we implement authentication?) by gathering targeted Git evidence first, then reasoning over it — separating FACT from inference.

Installation

Install AH Git Manager from the VS Code Marketplace:

1. Open the Extensions view (Ctrl+Shift+X).
2. Search AH Git Manager.
3. Click Install.

Or install from the command line:

code --install-extension ahgit.ah-git-manager

Requirements: VS Code 1.105 or newer, Git on PATH, and a workspace folder containing a Git repository.

How to use

1. Open the AH Git Manager activity-bar view.
2. Click ⚙ Configure AI (or run AH Git Manager: Configure AI Provider from the command palette), pick a provider, model, and API key. Keys are stored in VS Code SecretStorage. Local providers (Ollama, LM Studio) need no key.
3. Type a command in the sidebar box and press Enter (↑↓ recalls history):

/status          working tree + branch overview
/diff            AI review of your current changes
/commit-message  Conventional Commit suggestions
/branches        local + remote branches
/help            every command

4. Use the sidebar shortcuts:
   • 🔑 Keys — manage per-provider API keys.
   • ⚡ AI Auto-commit — AI drafts a message, you review and edit it, then confirm to stage + commit. Afterwards you are asked whether to push or sync.
5. Prefer plain words? Try /ask where did we implement authentication?

Full walkthrough: docs/getting-started.md.

Commands at a glance

Complete reference with usage and examples: docs/commands.md.

Safety by design

• Writes (stage, commit, push, pull --rebase) run only after your explicit confirmation in the UI. Nothing is pushed automatically.
• No reset --hard, branch -D, push --force, clean -fd, or automatic conflict resolution anywhere in the codebase.
• AI context is redacted (.env, private keys, tokens) and capped; AI output is informational and never executed as shell.

Details: docs/git-intelligence.md, SECURITY.md.

Documentation

Development

npm install
npm run lint       # type-check
npm test           # vitest
npm run compile    # extension + webview build
npm run package:vsix  # build ah-git-manager-0.1.0.vsix (compiles first via vscode:prepublish)

See CONTRIBUTING.md, docs/architecture.md.

License

MIT — see LICENSE.

code --install-extension ahgit.ah-git-manager

/status          نمای وضعیت و شاخه
/diff            بازبینی هوشمند تغییرات جاری
/commit-message  پیشنهاد پیام کامیت استاندارد
/branches        شاخه‌های محلی و ریموت
/help            همه فرمان‌ها

npm install
npm run lint
npm test
npm run compile
npm run package:vsix  # ساخت فایل نصبی vsix.