Releases: synthesiseng/gitrole
v0.7.5
v0.7.4
v0.7.3
v0.7.2
v0.7.1
v0.7.0
Summary
gitrole v0.7.0 adds a small onboarding command for users who already have the correct Git identity configured.
Use gitrole import current --name <role> to save the effective current commit identity as a named role without retyping name and email.
Notable Changes
- add
gitrole import current --name <role> - import the effective current commit identity from the current repo context
- prefer repo-local identity when a local override is active
- keep import strict:
- no SSH key discovery
- no GitHub user or host inference
- no automatic switching
- clarify the docs around:
currentvsstatus- first-time quickstart vs common next steps
Breaking Changes
- None
Docs
- Docs: https://docs.gitrole.dev
Package
v0.6.0
Summary
gitrole v0.6.0 completes the repo-policy workflow.
This release adds gitrole pin <role> for creating a strict repo-local .gitrole policy and gitrole resolve --json for exposing repo policy to scripts, prompts, and agents.
Notable Changes
- add
gitrole pin <role> - add
gitrole resolve --json - improve the repo-policy guide for
.gitrole
Breaking Changes
- None
Docs
- Docs: https://docs.gitrole.dev
Package
v0.4.1
Summary
gitrole v0.4.1 is the first release where the core command set and identity-alignment model are in place.
It gives developers a focused CLI for switching Git identities across work, personal, client, and shared repositories, then verifying that commit identity, remote configuration, and SSH auth are aligned before pushing.
Notable Changes
- switch saved Git roles globally or per repository with
gitrole use - check the current repo quickly with
gitrole status - inspect full identity, remote, and SSH state with
gitrole doctor - use machine-readable output:
gitrole status --shortgitrole doctor --json
- rewrite
originto the expected SSH host alias withgitrole remote set - add repo-local identity policy via
.gitrole - add
gitrole resolvefor repo-local preferred role lookup - support allowed vs default roles for shared and org repositories
- keep warnings focused on actionable mismatches rather than assumptions
Why this release matters
This is the release where gitrole becomes a reliable identity-management tool rather than just a profile switcher.
It now covers the core workflow:
- save a role
- switch the repo to it
- verify the repo before committing or pushing
Docs
gitrole: v0.5.0
0.5.0 (2026-04-12)
Features
- cli: add doctor --json output (f263db5)
- cli: add doctor --json output (17b2412)
- cli: add gitrole status command (02a19eb)
- cli: add gitrole status command (9fa86ef)
- cli: add gitrole v0.2.0 repo and auth diagnostics (4df14b5)
- cli: add scoped role switching (9e49233)
- cli: add scoped role switching (61b69ae)
- cli: add v0.2 repo and auth diagnostics (69d73f7)
- cli: add verify command and status history hint (fc375d0)
- cli: add verify command and status history hint (a6d3c2f)
- cli: implement gitrole v0.1.0 (6c99479)
- cli: simplify command surface for v0.3.0 (3fd4aab)
- cli: simplify command surface for v0.3.0 (08e3d2d)
- implement gitrole v0.1.0 CLI (946d29c)
- repo-policy: add .gitrole support and resolve command (337251b)
- repo-policy: add .gitrole support and resolve command (673e958)
Bug Fixes
- ci: release please app id variable (#30) (ebd172d)
- diagnosis: make diagnosis warnings expectation-based and add agent workflow docs (0432538)
- diagnosis: stop treating githubUser as remote owner expectation (82b49d0)
- diagnosis: stop treating githubUser as remote owner expectation (e469ee3)
- diagnosis: warn only on explicit expectations (85d4bab)
- docs: aligned docs (894f095)
- docs: aligned logo (baa37ef)
- docs: centered logo (45272c8)
- docs: remove non-ASCII CSS comment characters (b14fc8d)
- docs: restore Eleventy docs build scripts (9b6bc97)
- docs: restore Eleventy docs build scripts (79237cc)
- docs: switch logo (e5af66b)
- status: separate current identity from commit history (e775bf2)
- status: separate current identity from commit history (233334c)