Inject release version into drift binary

.claude/skills/drift/SKILL.md

@@ -3,10 +3,10 @@ name: drift
 description: Drift spec-to-code anchor conventions. Use when editing code that is bound by drift specs, updating specs, working with drift frontmatter, or when drift check reports stale anchors.
 drift:
   files:
-    - src/main.zig@a7ffa398
-    - src/frontmatter.zig@a7ffa398
-    - src/scanner.zig@a7ffa398
-    - src/vcs.zig@a7ffa398
+    - src/main.zig@2d3a4080
+    - src/frontmatter.zig@2d3a4080
+    - src/scanner.zig@2d3a4080
+    - src/vcs.zig@2d3a4080
 ---
 
 # Drift

.github/workflows/release.yml

@@ -62,7 +62,7 @@ jobs:
           version: 0.15.2
 
       - name: Build
-        run: zig build -Doptimize=ReleaseSafe -Dtarget=${{ matrix.zig-target }} ${{ matrix.zig-cpu && format('-Dcpu={0}', matrix.zig-cpu) || '' }}
+        run: zig build -Doptimize=ReleaseSafe -Dversion=${{ github.ref_name }} -Dtarget=${{ matrix.zig-target }} ${{ matrix.zig-cpu && format('-Dcpu={0}', matrix.zig-cpu) || '' }}
 
       - name: Package
         run: |

README.md

@@ -11,9 +11,22 @@ Any markdown file in your repo can declare anchors to code — specific files or
 curl -fsSL https://drift.fp.dev/install.sh | sh
 ```
 
+To install a specific version:
+
+```bash
+curl -fsSL https://drift.fp.dev/install.sh | sh -s -- --version vX.Y.Z
+```
+
+Or build from source:
+
+```bash
+zig build -Doptimize=ReleaseSafe --prefix ~/.local
+```
+
 ### Coding agent skill (Claude Code, Codex)
 
 ```bash
+curl -fsSL https://drift.fp.dev/install.sh | sh
 npx skills add fiberplane/drift
 ```
 

build.zig

@@ -3,13 +3,17 @@ const std = @import("std");
 pub fn build(b: *std.Build) void {
     const target = b.standardTargetOptions(.{});
     const optimize = b.standardOptimizeOption(.{});
+    const version = b.option([]const u8, "version", "Drift version string") orelse "0.0.0-dev";
 
     // Dependencies
     const clap_dep = b.dependency("clap", .{});
 
     // Build tree-sitter C library from vendor sources
     const ts_module = buildTreeSitter(b, target, optimize);
 
+    const build_options = b.addOptions();
+    build_options.addOption([]const u8, "version", version);
+
     // Root module
     const root_module = b.createModule(.{
         .root_source_file = b.path("src/main.zig"),
@@ -21,6 +25,7 @@ pub fn build(b: *std.Build) void {
             .{ .name = "tree_sitter", .module = ts_module },
         },
     });
+    root_module.addOptions("build_options", build_options);
     linkGrammars(b, root_module);
 
     // Executable

docs/CLI.md

@@ -1,7 +1,7 @@
 ---
 drift:
   files:
-    - src/main.zig@a7ffa398
+    - src/main.zig@2d3a4080
 ---
 
 # CLI Reference

docs/DECISIONS.md

@@ -1,9 +1,9 @@
 ---
 drift:
   files:
-    - src/main.zig@a7ffa398
-    - src/symbols.zig@a7ffa398
-    - src/vcs.zig@a7ffa398
+    - src/main.zig@2d3a4080
+    - src/symbols.zig@2d3a4080
+    - src/vcs.zig@2d3a4080
 ---
 
 # Decisions

docs/DESIGN.md

@@ -1,11 +1,11 @@
 ---
 drift:
   files:
-    - src/main.zig@a7ffa398
-    - src/frontmatter.zig@a7ffa398
-    - src/scanner.zig@a7ffa398
-    - src/symbols.zig@a7ffa398
-    - src/vcs.zig@a7ffa398
+    - src/main.zig@2d3a4080
+    - src/frontmatter.zig@2d3a4080
+    - src/scanner.zig@2d3a4080
+    - src/symbols.zig@2d3a4080
+    - src/vcs.zig@2d3a4080
 ---
 
 # Design

docs/RELEASING.md

@@ -1,9 +1,9 @@
 ---
 drift:
   files:
-    - .github/workflows/release.yml@xxoutkyz
-    - .github/workflows/ci.yml@xxoutkyz
-    - cliff.toml@xxoutkyz
+    - .github/workflows/release.yml@2d3a4080
+    - .github/workflows/ci.yml@2d3a4080
+    - cliff.toml@2d3a4080
 ---
 
 # Releasing

src/main.zig

@@ -1,4 +1,5 @@
 const std = @import("std");
+const build_options = @import("build_options");
 const clap = @import("clap");
 const frontmatter = @import("frontmatter.zig");
 const scanner = @import("scanner.zig");
@@ -7,7 +8,7 @@ const vcs = @import("vcs.zig");
 
 const Spec = scanner.Spec;
 
-const version = "0.1.0";
+const version = build_options.version;
 
 const SubCommand = enum {
     check,