gitpro
The right Git identity, SSH key and signature for every repository.
gitpro.dev · PyPI · VS Code · made by Yantrakar
Work on a company repository, commit with your work email. Switch to a personal project, use your personal identity. Gitpro chooses by remote URL, not by where you happened to clone the repository.
Useful when you have more than one GitHub/GitLab account, separate work and personal keys, or keep finding the wrong email on your commits.
Try it
Requires Linux or macOS, Git 2.36+, Python 3.9+ and OpenSSH. Install from PyPI with pipx.
pipx install gitpro
gitpro setup --write
The wizard helps you choose identities, Git hosts and owners, existing SSH keys, and optional signing. No TOML editing is needed for basic setup. Review the configuration before saving; nothing is applied to Git or SSH yet.
gitpro plan # see exactly what would change
gitpro apply -y # explicitly apply the reviewed changes
Then, inside a repository:
gitpro why # see the expected identity and anything overriding it
Already have a config? Run gitpro setup --write to add another identity without losing
your existing settings or comments. Prefer editing files? The
user guide covers the full TOML format.
What you get
- Work/personal separation: names, emails, SSH keys and signing per host/owner.
- Answers, not guesswork:
gitpro whyexplains mismatches and suggests a fix. - A safety net: optional hooks can block wrong-identity commits and pushes.
- Editor and container support: see your identity in VS Code and carry it into dev containers.
Gitpro generates ordinary Git and SSH configuration; it needs no background service. Changes can be previewed, existing hand-written files are backed up, and key creation or uploads are never part of the setup wizard.
Using VS Code?
Run gitpro: Set Up Identities from the Command Palette to open the same wizard in a terminal. The extension also shows the current identity and helps find repository-level overrides. Install the extension.
Go further when you need to
For agents, the versioned workflow provides structured preflight, identity-scoped execution and durable idempotency for commits, pushes and GitHub PRs. Persistent changes use exact proposals, human approval by default, optional operator-scoped preauthorization, and recoverable apply. MCP execution is opt-in.
| I want to… | Start here |
|---|---|
| Understand matching, SSH keys or signing | Configuration |
| Find wrong identities or forgotten work | Daily use · Finding things |
| Use dev containers | Container setup |
| Configure team policy, CI or AI assistants | Teams and CI · AI assistants |
| Look up a command or undo changes | Command reference · Undo |
| Troubleshoot or contribute | Troubleshooting · Development |
The detailed TOML, YAML and command examples live in the guide, not on the getting-started path.
License
1 maintainer
Metadata
1 maintainer
Release files for gitpro 0.3.3
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 |
|---|---|---|---|---|
| gitpro-0.3.3.tar.gz | 287.3 kB | With provenance | Details for gitpro-0.3.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gitpro-0.3.3-py3-none-any.whl | Python 3 | none | any | Details for gitpro-0.3.3-py3-none-any.whl |
Total release size: 604.1 kB
Release files / gitpro-0.3.3.tar.gz
| Download URL | gitpro-0.3.3.tar.gz |
|---|---|
| Size | 287.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a1a94b8584613d7aea3ab803db5e750ae0c9a6ea0cdc7c3610cbd1385d2dba97
|
|
BLAKE2b-256 checksum How to use checksums |
c955f476b495c1c7e6b8ef1c05682785c327a1737179f11fd9877cb9e5f81d40
|
| 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 15, 2026.
Transparency logRelease files / gitpro-0.3.3-py3-none-any.whl
| Download URL | gitpro-0.3.3-py3-none-any.whl |
|---|---|
| Size | 316.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b92283d5e00989c1ae1ec44e3cdb8f685b9268a76eec68282237f4b45bb8d6d5
|
|
BLAKE2b-256 checksum How to use checksums |
52c389c8eba18670a1d4d44ac1df83967b900d4e7f583433a63222cd86d9acc6
|
| 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 15, 2026.
Transparency logSecurity for gitpro 0.3.3
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 gitpro-0.3.3.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 15, 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.
