Skip to content

Releases: zircote/git-adr

v1.0.0

16 Jan 03:49

Choose a tag to compare

What's Changed

Full Changelog: v0.3.0...v1.0.0

v0.3.0

15 Jan 18:51

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/tap
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.3.0
curl -sL https://github.com/zircote/git-adr/releases/download/v0.3.0/git-adr-0.3.0.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Claude Code Skill

Install the git-adr skill for AI-assisted ADR management:

# Download and extract to your skills directory
curl -sL https://github.com/zircote/git-adr/releases/download/v0.3.0/git-adr-0.3.0.skill -o git-adr.skill
unzip git-adr.skill -d ~/.claude/skills/

The skill enables Claude to create ADRs from natural language, execute git-adr commands, and guide ADR best practices.

What's Changed

  • ci: bump actions/setup-python from 5 to 6 by @dependabot[bot] in #47
  • ci: bump actions/checkout from 4 to 6 by @dependabot[bot] in #48
  • ci: bump actions/download-artifact from 6 to 7 by @dependabot[bot] in #49
  • Fix CI: resolve formatting and type errors by @Copilot in #51

Full Changelog: v0.2.4...v0.3.0

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.3.0/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.3.0/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

v0.2.4

21 Dec 05:58

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/tap
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.2.4
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.4/git-adr-0.2.4.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Claude Code Skill

Install the git-adr skill for AI-assisted ADR management:

# Download and extract to your skills directory
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.4/git-adr-0.2.4.skill -o git-adr.skill
unzip git-adr.skill -d ~/.claude/skills/

The skill enables Claude to create ADRs from natural language, execute git-adr commands, and guide ADR best practices.

Full Changelog: v0.2.3...v0.2.4

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.4/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.4/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

v0.2.3

18 Dec 19:43

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/tap
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.2.3
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.3/git-adr-0.2.3.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Claude Code Skill

Install the git-adr skill for AI-assisted ADR management:

# Download and extract to your skills directory
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.3/git-adr-0.2.3.skill -o git-adr.skill
unzip git-adr.skill -d ~/.claude/skills/

The skill enables Claude to create ADRs from natural language, execute git-adr commands, and guide ADR best practices.

What's Changed

  • Chore/rename homebrew tap by @zircote in #38
  • fix(core): check config flag instead of notes existence in is_initialized() by @zircote in #44
  • [WIP] Fix CI errors and resolve issues from review #40 by @Copilot in #45
  • fix(ci): add ADR init step and improve test isolation by @zircote in #46
  • Refactor duplicated command initialization boilerplate into shared helper by @Copilot in #40

Full Changelog: v0.2.2...v0.2.3

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.3/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.3/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

v0.2.2

17 Dec 16:25

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/tap
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.2.2
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.2/git-adr-0.2.2.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Claude Code Skill

Install the git-adr skill for AI-assisted ADR management:

# Download and extract to your skills directory
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.2/git-adr-0.2.2.skill -o git-adr.skill
unzip git-adr.skill -d ~/.claude/skills/

The skill enables Claude to create ADRs from natural language, execute git-adr commands, and guide ADR best practices.

Full Changelog: v0.2.1...v0.2.2

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.2/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.2/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

v0.2.1

17 Dec 15:26

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/tap
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.2.1
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-0.2.1.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Claude Code Skill

Install the git-adr skill for AI-assisted ADR management:

# Download and extract to your skills directory
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-0.2.1.skill -o git-adr.skill
unzip git-adr.skill -d ~/.claude/skills/

The skill enables Claude to create ADRs from natural language, execute git-adr commands, and guide ADR best practices.

What's Changed

  • feat: Git hooks, SDLC integration, and interactive init wizard by @zircote in #32
  • feat(skill): add skill packaging to release workflow by @zircote in #33
  • fix: remediate code review findings (security, performance, architecture) by @zircote in #34
  • chore: rename homebrew-git-adr to homebrew-tap by @zircote in #35
  • chore: rename Homebrew tap and enhance GitHub ecosystem by @zircote in #36
  • Release v0.2.1 by @Copilot in #37

Full Changelog: v0.2.0...v0.2.1

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

Standalone Binaries

Pre-built binaries are available for immediate download - no Python required!

Platform Download SHA256
macOS ARM64 (M1/M2/M3) git-adr-macos-arm64.tar.gz See checksums.txt
Linux x86_64 git-adr-linux-x86_64.tar.gz See checksums.txt
Windows x86_64 git-adr-windows-x86_64.zip See checksums.txt

macOS Intel users: Use Homebrew: brew install zircote/git-adr

Quick Install (Unix)

# macOS ARM64
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-macos-arm64.tar.gz | tar xz
sudo mv git-adr-macos-arm64/git-adr /usr/local/bin/

# Linux
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.1/git-adr-linux-x86_64.tar.gz | tar xz
sudo mv git-adr-linux-x86_64/git-adr /usr/local/bin/

v0.2.0

16 Dec 17:26

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/git-adr
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.2.0
curl -sL https://github.com/zircote/git-adr/releases/download/v0.2.0/git-adr-0.2.0.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

What's Changed

  • feat: add PyInstaller binary distribution + git adr issue command by @zircote in #31

Full Changelog: v0.1.7...v0.2.0

v0.1.7

16 Dec 16:32

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/git-adr
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.1.7
curl -sL https://github.com/zircote/git-adr/releases/download/v0.1.7/git-adr-0.1.7.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Full Changelog: v0.1.6...v0.1.7

v0.1.6

16 Dec 16:28

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/git-adr
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.1.6
curl -sL https://github.com/zircote/git-adr/releases/download/v0.1.6/git-adr-0.1.6.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

What's Changed

  • feat: add Git hooks and SDLC integration by @zircote in #29
  • feat: add git adr issue command for GitHub issue creation by @zircote in #28

Full Changelog: v0.1.5...v0.1.6

v0.1.5

16 Dec 08:19

Choose a tag to compare

Installation

Homebrew (macOS)

brew tap zircote/git-adr
brew install git-adr

Via pip/uv

pip install git-adr
# or
uv tool install git-adr

From release tarball (includes man pages + completions)

# Download and extract (replace VERSION with actual version, e.g., 0.1.0)
VERSION=v0.1.5
curl -sL https://github.com/zircote/git-adr/releases/download/v0.1.5/git-adr-0.1.5.tar.gz | tar xz
cd git-adr-*/

# Install (installs package via pip/uv, man pages, and completions)
./install.sh --local  # or: sudo ./install.sh

# Or install man pages only
sudo ./install.sh --man-only

Shell completion

After installing, enable shell completion:

git-adr completion bash --install
git-adr completion zsh --install
git-adr completion fish --install

Usage

git adr init              # Initialize in a repository
git adr new "Title"       # Create an ADR
git adr list              # List all ADRs
man git-adr               # View documentation

Full Changelog: v0.1.4...v0.1.5