Fix module path, version endpoint auth, and several CI/CD issues

- Rename module path from github.com/yourorg/beads_server to
  github.com/vector76/beads_server throughout (go.mod, all imports,
  ldflags in Makefile and release.yml) — the yourorg placeholder was
  never updated, breaking go install
- Fix bs --version to contact /api/v1/version without requiring
  BS_TOKEN; the endpoint is unauthenticated by design and the CLI
  should use it that way
- Add mkdir -p to Makefile platform targets so make clean && make linux
  no longer fails on a missing build/ directory
- Add make install to README build-from-source section
- Update docs: note bs --version plain-text exception to JSON-only
  output rule; add macOS to cross-compilation platform list

Author: vector76

.github/workflows/release.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Build binaries
         run: |
           VERSION=${GITHUB_REF_NAME#v}
-          LDFLAGS="-s -w -X 'github.com/yourorg/beads_server/internal/cli.version=${VERSION}'"
+          LDFLAGS="-s -w -X 'github.com/vector76/beads_server/internal/cli.version=${VERSION}'"
           mkdir -p build
           GOOS=linux   GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o build/bs-linux-amd64       ./cmd/bs
           GOOS=windows GOARCH=amd64 go build -ldflags="${LDFLAGS}" -o build/bs-windows-amd64.exe ./cmd/bs

Makefile

@@ -2,9 +2,9 @@ BINARY_NAME := bs
 BUILD_DIR := build
 SRC := ./cmd/bs
 VERSION ?= $(patsubst v%,%,$(shell git describe --tags --always --dirty 2>/dev/null || echo "dev"))
-LDFLAGS := -X 'github.com/yourorg/beads_server/internal/cli.version=$(VERSION)'
+LDFLAGS := -X 'github.com/vector76/beads_server/internal/cli.version=$(VERSION)'
 
-.PHONY: all build test clean linux windows darwin-arm64 darwin-amd64
+.PHONY: all build test clean install linux windows darwin-arm64 darwin-amd64
 
 all: test build
 
@@ -14,16 +14,23 @@ test:
 	go test ./...
 
 linux:
+	@mkdir -p $(BUILD_DIR)
 	GOOS=linux GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 $(SRC)
 
 windows:
+	@mkdir -p $(BUILD_DIR)
 	GOOS=windows GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe $(SRC)
 
 darwin-arm64:
+	@mkdir -p $(BUILD_DIR)
 	GOOS=darwin GOARCH=arm64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-arm64 $(SRC)
 
 darwin-amd64:
+	@mkdir -p $(BUILD_DIR)
 	GOOS=darwin GOARCH=amd64 go build -ldflags="$(LDFLAGS)" -o $(BUILD_DIR)/$(BINARY_NAME)-darwin-amd64 $(SRC)
 
+install: linux
+	install -m 0755 $(BUILD_DIR)/$(BINARY_NAME)-linux-amd64 $(shell go env GOPATH)/bin/$(BINARY_NAME)
+
 clean:
 	rm -rf $(BUILD_DIR)

README.md

@@ -8,6 +8,12 @@ An agent-first issue tracker. A single executable (`bs`) that runs as either an
 
 Pre-built binaries are available on the [Releases page](https://github.com/vector76/beads_server/releases/latest).
 
+**Via go install (any platform, no root required)**
+```bash
+go install github.com/vector76/beads_server/cmd/bs@latest
+```
+Installs to `$GOPATH/bin` (typically `~/go/bin`). The version is embedded automatically.
+
 **Linux (amd64)**
 ```bash
 curl -L https://github.com/vector76/beads_server/releases/latest/download/bs-linux-amd64 -o bs
@@ -55,6 +61,7 @@ Or use the Makefile for cross-compiled binaries:
 
 ```bash
 make build        # produces build/bs-linux-amd64, build/bs-windows-amd64.exe, build/bs-darwin-arm64, build/bs-darwin-amd64
+make install      # builds linux/amd64 and installs to $GOPATH/bin/bs (Linux only)
 ```
 
 ### Start the server

cmd/bs/main.go

@@ -3,7 +3,7 @@ package main
 import (
 	"os"
 
-	"github.com/yourorg/beads_server/internal/cli"
+	"github.com/vector76/beads_server/internal/cli"
 )
 
 func main() {

cmd/bs/main_test.go

@@ -42,9 +42,12 @@ func TestBinaryVersionFlag(t *testing.T) {
 		t.Fatalf("binary exited with error: %v\n%s", err, out)
 	}
 
-	output := strings.TrimSpace(string(out))
-	if !strings.HasPrefix(output, "bs version ") {
-		t.Errorf("expected output to start with 'bs version ', got: %q", output)
+	output := string(out)
+	if !strings.Contains(output, "client: ") {
+		t.Errorf("expected output to contain 'client: ', got: %q", output)
+	}
+	if !strings.Contains(output, "server: ") {
+		t.Errorf("expected output to contain 'server: ', got: %q", output)
 	}
 }
 

docs/architecture.md

@@ -113,7 +113,7 @@ go test ./e2e/...
 
 **Single binary, two modes.** The `bs` binary is both server and CLI client. `bs serve` starts the HTTP server; every other command is a client that talks to the server via HTTP. This avoids separate installs and keeps deployment simple.
 
-**JSON-only output.** All CLI output is pretty-printed JSON. No tables, no colors, no human-oriented formatting. Agents parse JSON natively; humans can pipe through `jq`. This eliminates an entire class of formatting/parsing bugs.
+**JSON-only output.** All CLI output is pretty-printed JSON except `bs --version`, which outputs plain text for human readability. No tables, no colors, no human-oriented formatting for command output. Agents parse JSON natively; humans can pipe through `jq`. This eliminates an entire class of formatting/parsing bugs.
 
 **Chi for routing, cobra for CLI.** Both are lightweight, widely used Go libraries. Chi adds path parameters and middleware grouping on top of `net/http`. Cobra provides flag parsing, help text, and command grouping. Neither imposes architectural constraints.
 

docs/design-goals.md

@@ -9,7 +9,7 @@ An issue tracker optimized for coding agent use. A single executable (`bs`) that
 1. **Agent-first**: All output is JSON (pretty-printed). Agents parse JSON; humans can read it directly or pipe through `jq`
 2. **Simple and focused**: Only issue tracking. No git sync, no plugins, no bloat
 3. **Client-server**: Server is the single source of truth. Works across worktrees, containers, and remote hosts
-4. **Easy to run**: Single binary, minimal configuration. Cross-compiled for Linux and Windows
+4. **Easy to run**: Single binary, minimal configuration. Cross-compiled for Linux, Windows, and macOS
 5. **Multi-agent**: Multiple agents can share one tracker, claim work items, and resume aborted tasks
 
 ## Out of Scope

e2e/e2e_test.go

@@ -11,10 +11,10 @@ import (
 	"strings"
 	"testing"
 
-	"github.com/yourorg/beads_server/internal/cli"
-	"github.com/yourorg/beads_server/internal/model"
-	"github.com/yourorg/beads_server/internal/server"
-	"github.com/yourorg/beads_server/internal/store"
+	"github.com/vector76/beads_server/internal/cli"
+	"github.com/vector76/beads_server/internal/model"
+	"github.com/vector76/beads_server/internal/server"
+	"github.com/vector76/beads_server/internal/store"
 )
 
 const testToken = "e2e-test-secret"

go.mod

@@ -1,4 +1,4 @@
-module github.com/yourorg/beads_server
+module github.com/vector76/beads_server
 
 go 1.25.5
 

internal/cli/commands_query_test.go

@@ -5,8 +5,8 @@ import (
 	"os"
 	"testing"
 
-	"github.com/yourorg/beads_server/internal/model"
-	"github.com/yourorg/beads_server/internal/store"
+	"github.com/vector76/beads_server/internal/model"
+	"github.com/vector76/beads_server/internal/store"
 )
 
 func TestList_Default(t *testing.T) {