Quick AI Push & Merge

Lightweight, one-click Git actions in the VS Code status bar. No runtime npm dependencies, bundled AI SDK, or extension-operated backend.

Push — save, AI commit, and push

Click Push to:

1. Save edited files belonging to the selected repository.
2. Include all staged, unstaged, deleted, and nonignored untracked files.
3. Generate a concise commit subject using a VS Code language model.
4. Commit and push the current branch, creating the remote branch and setting upstream when needed.

If all changes are already committed, Push skips AI and pushes existing commits directly. An existing upstream branch name is respected. The remote repository must already exist and be configured.

This is an immediate action, not a review dialog. Push includes all eligible changes in the selected repository, including changes you previously left unstaged. Ignored untracked files are excluded; tracked files remain tracked even if later added to .gitignore.

Merge — committed changes only, local edits untouched

Click Merge to merge the current branch's committed HEAD into the remote default branch and push the result.

• Works even with staged, unstaged, untracked, or unsaved editor changes.
• Does not save editors, stage files, commit local edits, stash, or switch your current branch.
• Performs the merge in an isolated detached temporary worktree, using a regular merge commit.
• Preserves your current branch, original index, local file contents, and unsaved editor buffers.
• Discovers the remote default branch, with a fallback to main / master; the target is configurable.
• Does not advance your local main branch. Update it later with your normal Git workflow.

Both actions use normal pushes: no force push, no hook bypass, no automatic pull/rebase, and no bypass of protected branches. Conflicts or rejected pushes stop the operation. Merge's disposable conflict worktree is removed, leaving your source workspace untouched; resolve conflicts through your usual Git workflow before retrying.

Requirements

• VS Code 1.95 or later and Git available to VS Code.
• A trusted Git workspace, a configured remote repository, and working remote credentials.
• For AI commits: GitHub Copilot or another provider exposing models through the VS Code Language Model API, with any required account access. Provider subscriptions, quotas, or charges are separate.

First AI use may show VS Code's own model permission dialog; the extension cannot bypass it. There are no additional Push or Merge confirmation dialogs. Committed-only Push and Merge do not require AI.

If no model is available or AI generation fails, dirty Push reports an error instead of inventing a fallback message. It does not stage or commit your changes in that case. If files change while AI is writing the message, Push stops before staging so you can retry with the latest changes. If a push is rejected after a commit succeeds, the local commit remains available.

Settings

Repository selection and commands

Uses the active editor's Git repository, or the only repository in the workspace. An ambiguous multi-repository workspace asks which repository to act on.

Command Palette:

• Quick AI: Commit All & Push
• Quick AI: Merge Committed Changes to Main & Push
• Quick AI: Show Output

Logs are available in Output > Quick AI Push. Diff contents are not logged.

Privacy and safety

AI commits send changed-file names and a bounded patch to your selected VS Code AI provider. That provider's privacy and data-handling terms apply. Git operations contact your configured Git remote.

The extension collects no telemetry, stores no separate API keys, and uses no extension-operated service. Do not include secrets in tracked files; .gitignore does not protect secrets already tracked by Git.

Git hooks, signing, authentication, and server-side protections remain active. User-controlled Git hooks or filters may have their own external side effects. Operations within one extension host are serialized; external Git tools may still run concurrently.

Known limitations

• No automatic conflict resolution or pull request creation.
• Dirty submodule contents are not recursively committed. Push submodules separately.
• Merge requires the remote fetch and push URLs to match. Mirror remotes and multiple push URLs are rejected.
• Finish any existing merge, rebase, cherry-pick, revert, or bisect before using these actions.
• Detached HEAD, an empty source branch, and merging the main branch into itself are not supported.
• Abrupt VS Code or OS termination may leave an owned temporary worktree. Cleanup failures log its path.

中文说明

状态栏 Push：自动保存当前仓库文件，将 staged / unstaged / 未忽略的新文件一并提交，由 AI 生成提交消息，再推送当前分支；远程分支不存在时自动创建。

状态栏 Merge：只将当前分支已提交的代码合并到远程主分支并推送。允许工作区存在未提交改动，保留原分支、暂存区、未提交文件及未保存的编辑器内容，不自动提交、stash 或切换分支。

首次使用 AI 可能需要 VS Code 的模型授权。不会 force push，不会绕过 Git hooks 或远程分支保护。

License

MIT. Copyright 2026 Easton Hou.