Latest Update: v1.0.0 — TypeScript refactor, fish shell support, and bug fixes!
This extension enhances your Git workflow by enabling the execution of add, commit, and push commands through a streamlined, single command interface. It removes the need for quotation marks around commit messages and reduces Git commands to short, memorable aliases.
-
Successful Push
- Efficient Git Operations: Execute git add, commit, and push with a single command or keybind, directly from your editor — no quotation marks needed.
- Simple Commands: Condenses traditional Git commands into shorter versions that are easier to type and remember, even for commit messages with spaces or punctuation.
- Real-Time Git Status: A dynamic status bar indicator shows whether your branch is ahead, behind, or diverged from the remote at a glance.
- Forced Remote Sync: The
acpcommand checks that your local branch is in sync with remote before pushing, preventing conflicts. - Customizable Commit Messages: Type commit messages directly on the command line — no quotes required for normal messages.
- Cross-Shell Compatibility: Full support for bash, zsh, and fish. The Quick Status indicator works in all environments regardless of shell.
| Shell | Status |
|---|---|
| zsh | ✅ Supported |
| bash | ✅ Supported |
| fish | ✅ Supported (added in v1.0.0) |
If your shell is not auto-detected, set it manually under Settings → ACP Git Commands → Shell Type.
-
Successful Push Above
-
Commit Failed / Push Failed
-
Pull Before ACP
- Won't add or commit if a pull is needed.
Safety checks included in ACP
Diverged from Remote
-
When your local and remote branches have diverged, you must resolve it manually.
-
No Upstream Set
-
ACP checks for an upstream before pushing and tells you exactly how to set one.
-
No Repository Found
Extra
- No commands will run from a detached HEAD state.
Real-time Git status in your status bar (bottom left), always visible without running any commands.
- Up to Date —
- Behind —
- Ahead —
- Diverged —
- Not in a Repository —
Status refreshes on file changes and window focus. Remote sync (fetch) runs every 5 minutes.
A single keystroke types acp into your current terminal, or opens a new one if none is active.
- Mac:
CMD+OPTION+P - Windows/Linux:
CTRL+ALT+P - Change: Keyboard Shortcuts → search
Quick Push
These do not enforce remote sync — only acp does.
-
acm — Add all and commit.
-
cm — Commit only (no add).
-
add — Stage files. Adds all by default, or pass specific files.
- Install from the VS Code Marketplace.
- Open any Git workspace — the extension activates automatically.
- A success notification confirms the shell functions were installed.
- That's it. Open a new terminal and run
acp your commit message.
-
Special Characters: All commands support commit messages without quotes for normal text, spaces, and common punctuation (
. , - _). For special characters (e.g.,! # ^ @ & * ( ) > < { | }), wrap the message in quotes:acp "fix: resolve edge case with !important flag"
Git must be installed. No other dependencies. Restart any open terminals after the first install so the shell functions are sourced.
| Setting | Default | Description |
|---|---|---|
acpGitCommands.shellType |
(auto-detect) | Override shell detection. Options: bash, zsh, fish. |
gitStatus.fetchInterval |
300000 |
How often (ms) to fetch from remote for status bar. Set to 0 to disable. |
None currently. Please open an issue on GitHub if you find one.
- TypeScript: Rewrote entire extension in TypeScript with strict mode. Codebase split into four focused modules (
extension,statusBar,shellConfig,shellScripts). - Fish shell support: Added full support for the fish shell. All four commands (
acp,acm,add,cm) are available in idiomatic fish syntax. Config written to~/.config/fish/config.fish(directory created automatically if missing). - Shell setting now works: The
acpGitCommands.shellTypeVS Code setting is actually read and respected — previously it was ignored entirely. - Performance:
git fetchno longer runs on every file save or tab switch. Remote fetches happen only on the 5-minute interval; local status reads (git status -sb) handle all other updates. - Bug fixes: Resolved duplicate
cm()function definition in shell script, early-return inactivate()that prevented the Quick Push command from registering on first install, double command registration, and double event listener subscription.
Older release notes
- Quick Push: Type
acpinto your terminal with a single keystroke (CMD+OPT+P/CTRL+ALT+P) or via the command palette. - Activation Optimization: Extension now activates only within Git workspaces.
- Terminal Optimization: The
acpcommand is prepared in the active terminal without closing it. - Custom Terminal Names: Terminals reopen with their original names after a config update.
- Installation Fixes: Creates a shell config file if one doesn't exist.
- Quick Status: Real-time Git status in the status bar — ahead, behind, or diverged at a glance.
- Enhanced Compatibility: Improved bash support on macOS.
- On Uninstall: ACP functions are removed from your shell config on extension uninstall.
- Zsh Support: Reintroduced Zsh support across all platforms.
- Improved Error Handling: Clearer guidance when shell config is not detected.
- Add Command Enhancement:
addcan now stage specific files with detailed feedback. - Temporary File Assistance: When no config file is found, instructions open in a VS Code editor tab instead of writing to the desktop.
- Added error handling for commands run outside of Git repositories.
- Version checking to ensure users always run the latest ACP script.
- Enhanced branch sync — handles divergence and enforces pulls before pushing.
- Automatic updates for the ACP shell function on extension update.
- Detached HEAD and upstream branch handling.
- Initial release.
Enjoy using ACP Quickly — designed to make version control faster and less friction.