From 4031408b0e3580a352e9165d78ae9d4f47ce3278 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 30 Apr 2026 03:31:50 +0100
Subject: [PATCH] release: v0.1.0

---
 .github/workflows/ci.yml      |  7 ++++++
 .github/workflows/release.yml | 46 +++++++++++++++++++++++++++++++++++
 .goreleaser.yaml              | 36 +++++++++++++++++++++++++++
 CHANGELOG.md                  |  3 ++-
 README.md                     | 11 +++++++++
 5 files changed, 102 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/release.yml
 create mode 100644 .goreleaser.yaml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d8e36f5..9ecd341 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -59,3 +59,10 @@ jobs:
 
       - name: Build
         run: go build -ldflags "-X github.com/openclaw/gitcrawl/internal/cli.version=${GITHUB_SHA:0:7}" -o bin/gitcrawl ./cmd/gitcrawl
+
+      - name: Snapshot release build
+        uses: goreleaser/goreleaser-action@v7.1.0
+        with:
+          distribution: goreleaser
+          version: "~> v2"
+          args: release --snapshot --clean --skip=publish
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..d2ef652
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,46 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to (re)release (e.g. v0.1.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+          cache-dependency-path: go.sum
+
+      - name: Stash GoReleaser config
+        run: cp .goreleaser.yaml /tmp/.goreleaser.yaml
+
+      - name: Checkout release tag
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        run: git checkout ${{ inputs.tag }}
+
+      - name: GoReleaser
+        uses: goreleaser/goreleaser-action@v7.1.0
+        with:
+          distribution: goreleaser
+          version: "~> v2"
+          args: release --clean --config /tmp/.goreleaser.yaml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.goreleaser.yaml b/.goreleaser.yaml
new file mode 100644
index 0000000..dfd9a04
--- /dev/null
+++ b/.goreleaser.yaml
@@ -0,0 +1,36 @@
+version: 2
+
+project_name: gitcrawl
+
+changelog:
+  disable: true
+
+builds:
+  - id: gitcrawl
+    main: ./cmd/gitcrawl
+    binary: gitcrawl
+    env:
+      - CGO_ENABLED=0
+    ldflags:
+      - -s -w -X github.com/openclaw/gitcrawl/internal/cli.version={{ .Version }}
+    targets:
+      - darwin_amd64
+      - darwin_arm64
+      - linux_amd64
+      - linux_arm64
+      - windows_amd64
+      - windows_arm64
+
+archives:
+  - ids:
+      - gitcrawl
+    formats:
+      - tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    format_overrides:
+      - goos: windows
+        formats:
+          - zip
+
+checksum:
+  name_template: checksums.txt
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1781616..36da564 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## Unreleased
+## 0.1.0 - 2026-04-30
 
 - Add `gitcrawl sync --numbers` for exact issue and pull request hydration, including comment documents, without relying on list ordering or updated-time windows.
 - Implement `gitcrawl refresh` and `gitcrawl embed` so synced repositories can generate OpenAI embeddings and rebuild durable clusters end to end.
@@ -15,3 +15,4 @@
 - Tighten clustering precision by ignoring ambiguous one-digit prose references and requiring weak embedding edges to share concrete title tokens unless they have high similarity or direct GitHub reference evidence.
 - Treat later body-only issue references as weak evidence unless they share title overlap, while still preserving title and lead-body references for canonical issue/PR fix clusters.
 - Hide GitHub-closed members from latest-run cluster summaries and details by default; `--include-closed` still shows the full historical cluster.
+- Add release plumbing for GitHub release archives via GoReleaser.
diff --git a/README.md b/README.md
index 7b94a06..4037b39 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,17 @@ The TUI starts at `--min-size 5` and `--sort size`, like ghcrawl's saved default
 - a GitHub token for sync commands
 - an OpenAI API key only for summary and embedding commands
 
+## Install
+
+Download a release archive from GitHub releases or build from source:
+
+```bash
+git clone https://github.com/openclaw/gitcrawl.git
+cd gitcrawl
+go build -ldflags "-X github.com/openclaw/gitcrawl/internal/cli.version=$(git describe --tags --always --dirty)" -o bin/gitcrawl ./cmd/gitcrawl
+./bin/gitcrawl --version
+```
+
 ## Development
 
 ```bash