ACP Quickly: Enhanced Git Integration for Efficient Workflow!
Latest Update: NEW FEATURE QUICK PUSH (ACP Shortcut)!!
Latest Update: Extension activates only within git workspaces (Improves startup performance)!!
Last Update: NEW FEATURE QUICK STATUS (Remote sync status bar)!!
Quick Status works regardless of user shell.
Other Features require Z Shell or Bash. More shell support coming later.
Extension Link
This extension enhances your Git workflow by enabling the execution of add, commit, and push commands through a streamlined, single command interface. It simplifies the command process by removing the need for quotation marks around commit messages and reduces the complexity of Git commands, making them shorter and more intuitive.
Successful Push
Features
- Efficient Git Operations: Execute git add, commit, and push operations with a single command or key bind, directly from your editor, without the need for quotation marks.
- Simple Commands: Condenses traditional Git commands into shorter versions that are easier to type and remember, eliminating the need for quotation marks even in commit messages that include spaces or periods.
- Real-Time Git Status: Incorporates a dynamic status bar indicator that displays the current state of your Git repository. It provides immediate feedback if your branch is ahead, behind, or has diverged from the remote branch, enhancing your workflow by reducing the need to manually check the repository status.
- Forced Remote Sync: ACP command ensures that your local repository is synchronized with the remote before allowing any push operations, thus avoiding conflicts and ensuring a smooth workflow.
- Customizable Commit Messages: Allows you to directly type commit messages into the command line, streamlining the process of making quick updates or detailed logs.
- Cross-Shell Compatibility: Provides support across multiple shell environments including bash, zsh, and Windows Command Line, ensuring functionality across various development setups.
Command Example Usage
Visual demonstrations of the extension in action:
Pull Before ACP
- Won't add or commit if pull needed.
Checks included within ACP important!
Diverged from Remote
No Upstream Set
No Repository Found
Extra
- Won't allow any Commands from a detached state.
Quick Status - New Feature!
Introducing real-time Git status updates directly in your status bar (left side), keeping you informed of your repository's state without interrupting your workflow!
Up to Date
Behind
Ahead
Diverged
Not in a Repository
Updates could be delayed by up to 1 minute.
Introducing Quick Push: Seamless ACP
With a simple keystroke, Quick Push automatically types 'acp' into your current terminal, or opens a new one if no terminal is active.
Keybindings:
More Commands -
These don't force being in sync with remote only ACP does.
acm
cm
add
- On default adds all files. Takes in query for files as well.
Installation
Install the Extension:
Download and install the extension from the Visual Studio Code Marketplace.
You should get a notification of success or error.
Open Any Git Workspace
Thats it!
Usage Warning
Special Characters: The All Commands support commit messages without quotation marks for simple texts and spaces and .,-_ . For including special characters (e.g., !#^@&^@$@()&*&(!!!>:<{|}>), you will still need to encapsulate the message in quotes like this:
acp " !#^@&^@$@()& *&()!!!>:<{|}> "
Requirements
No additional requirements are needed for this extension except git duh, as it uses your existing git setup. Just restart or terminate your terminals after installation.
Extension Settings
This extension does not require specific settings for basic operation but depends on your existing git configuration.
Known Issues
None currently but please contact me if any are found.
Will be making more shells compatible.
Release Notes
0.9.0 Release Notes
New Features and Enhancements:
- Quick Push: Introduced the Quick Push feature, which allows you to perform Git add, commit, and push operations with a single command from VSCode, either via a shortcut or from the command palette.
- Activation Optimization: The extension now activates only within Git workspaces, enhancing its performance and usability by ensuring that Git commands are executed only in relevant contexts.
- Terminal Optimization: Enhanced the terminal handling to ensure that the 'acp' command is prepared in the active terminal without closing it, preserving the session's state.
- Custom Terminal Names: Added functionality to handle terminal sessions dynamically, allowing the extension to reopen terminals with their original names, thus maintaining a consistent development environment.
Older Notes!
0.8.0 Release Notes
New Features and Enhancements:
- Installation Fixes: Fixed issue where user did not have a shell config file by creating one for them else update existing config.
- Version Update: Updated to version 0.8.0 to include new features such as the Quick Status.
- Quick Status: Added a new feature that provides real-time Git status updates directly in your status bar. This feature allows you to see at a glance whether your repository is ahead, behind, or diverged without running any commands.
- Enhanced Compatibility: Improved support for bash on macOS, ensuring that users can seamlessly use the extension in their preferred shell environment.
- Performance Improvements: Enhanced the overall performance of the extension, making it faster and more responsive when executing Git commands.
- On Uninstall: The commands will actually be removed from your shell config file.
0.7.0 Release Notes
New Features and Enhancements:
Zsh Support: Reintroduced support for Zsh shell across all platforms (Darwin, Linux, Windows), enhancing the tool's compatibility.
Improved Error Handling: Refined error messages to provide clearer guidance and actions, particularly when the shell configuration file is not detected.
Add Command Enhancement: New add command functionality allows for specific or all files to be staged with detailed feedback on the action's success.
ACM and Add Command Functionalities: Updated acm and add commands to halt operations if no commit message is provided or if the repository is in a detached state.
Temporary File Assistance: When no shell configuration file is found, the extension now creates a temporary editable file in VS Code with manual setup instructions instead of creating a physical file on the desktop.
Interface Improvements: Enhanced markdown formatting for the extension's UI to better communicate the handling of different Git states and commands.
User Guides and Support: Updated documentation to include new features and commands, ensuring users fully understand how to utilize the new functionalities.
0.6.0
- New Feature: Added error handling for commands run outside of Git repositories to enhance user feedback.
0.5.0
- Version Checking: Integrated version checking to ensure users always run the latest ACP command script.
0.4.0
- Branch Sync Enhancements: Enhanced the extension to handle local branch comparisons with remote, manage divergences, and ensure required pulls are made before pushing.
0.3.0
- Automatic Updates: Implemented automatic updates for the ACP function to synchronize with extension updates.
0.2.0
- Detached Head and Upstream Handling: Added handling for detached HEAD states and upstream branch settings, improving stability and usability.
0.1.0
- Initial Release: Set up the basic functionality of the ACP command, laying the foundation for future enhancements.
Enjoy using ACP Quickly! This tool is designed to make your coding and version control process smoother and faster.
GIT-ACP-Shortcut-Extension
