acp - Automatic Commit Pusher
Turn your staged changes into a GitHub pull request with a single command.
No more branch naming, no browser tabs, no clicking through forms.
git add .
acp pr "fix: typo in readme"
PR created: https://github.com/vbvictor/acp/pull/12
That's it. PR created, you're back on your original branch.
What it does
When you run acp pr <commit message>, acp will:
- Validate you have staged changes
- Create a temporary branch
acp/{your-github-username}/{random-16-digits} - Commit your staged changes with your message
- Push the branch to origin repo
- Create a pull request to upstream if present of origin otherwise.
- Switch you back to your original branch
- Print the PR URL
The tool can also merge freshly created PR via --merge or --auto-merge options, see --help for more information.
Getting Started
Prerequisites: Python 3.10+, Git, and GitHub CLI (gh)
Authenticate GitHub CLI (if you haven't already):
gh auth login
Install from PyPI via pip or pipx:
pip install acp-gh
Or install the latest release directly from GitHub via pip or pipx:
pip install https://github.com/vbvictor/acp/releases/latest/download/acp_gh-1.9.0-py3-none-any.whl
Usage
Create basic PR:
git add .
acp pr "fix: correct calculation bug"
Create PR body message and run acp with verbose output:
acp pr "fix: resolve issue" -b "Closes #123" -v
Skip automatic PR creation and have a GitHub link to crate PR manually:
acp pr "feat: new feature" --interactive
Merge PR immediately after creation or use GitHub auto-merge feature:
# Squash and merge immediately (default merge method)
acp pr "fix: urgent hotfix" --merge
# Use different merge methods: merge, squash, or rebase
acp pr "fix: hotfix" --merge --merge-method merge
acp pr "feat: feature" --auto-merge --merge-method rebase
When merging branch immediately, temporary local branch and
remote tracking branch will also be deleted to keep workspace clean.
Contributing
Contributions welcome! Please open an issue if you have an idea or submit a pull request.
Shell autocomplete
To enable tab completion for the acp command:
Bash:
echo 'eval "$(register-python-argcomplete --no-defaults acp)"' >> ~/.bashrc
source ~/.bashrc
Zsh:
echo 'eval "$(register-python-argcomplete --no-defaults acp)"' >> ~/.zshrc
source ~/.zshrc
Fish:
register-python-argcomplete --shell fish acp > ~/.config/fish/completions/acp.fish
Developer environment
To create a virtual environment, install dev dependencies, and run tests:
make activate # Create venv and install dev dependencies
make test # Run tests
make lint # Run ruff/black
Submit your PR
Use acp itself to create your PR:
git add .
acp pr "feat: your awesome feature"
License
Metadata
Release files for acp-gh 1.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| acp_gh-1.9.0.tar.gz | 21.2 kB | With provenance | Details for acp_gh-1.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| acp_gh-1.9.0-py3-none-any.whl | Python 3 | none | any | Details for acp_gh-1.9.0-py3-none-any.whl |
Total release size: 40.0 kB
Release files / acp_gh-1.9.0.tar.gz
| Download URL | acp_gh-1.9.0.tar.gz |
|---|---|
| Size | 21.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5fbddc2bc12a61810ae36023e6bce6abf358604126eed246f027893bbc25b8ee
|
|
BLAKE2b-256 checksum How to use checksums |
e0a355e7f24a20fd53ba441361c67c08c9562fb76d73eea667638a66c7e1bd39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logRelease files / acp_gh-1.9.0-py3-none-any.whl
| Download URL | acp_gh-1.9.0-py3-none-any.whl |
|---|---|
| Size | 18.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
672da87e3abcaae52c86ef5e375f2d4c8a4685147190cfc10dc73c0d44e49b45
|
|
BLAKE2b-256 checksum How to use checksums |
ae8a2e07785eca1a14b00208529bb169d3cb0a12d3004a3b413486612742cf04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logSecurity for acp-gh 1.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for acp_gh-1.9.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.