Merge pull request #9 from squareup/readme-prerequisites

Add Claude Code as prerequisite, auto-install Go

Author: loganj

README.md

@@ -20,23 +20,19 @@ A local web app that **only** operates on markdown files inside `thoughts/` dire
 
 ### Prerequisites
 
-1. **Go 1.21+** - Required to build and run the server
-   ```bash
-   # On macOS with Homebrew
-   brew install go
-
-   # Or download from https://go.dev/dl/
-   ```
-
-2. **just** - Command runner for development tasks
+1. **just** - Command runner for development tasks (the only manual install)
    ```bash
    # On macOS with Homebrew
    brew install just
 
    # Or see https://github.com/casey/just for other platforms
    ```
 
-3. **fswatch** (optional) - For hot reload in dev mode (auto-installed via brew on macOS)
+The remaining dependencies are auto-installed when you run `just run` or `just dev`:
+
+2. **Claude Code** - Birdseye is designed to work with Claude Code agents for collaborative document review (see [go/claude-code](https://go/claude-code) for setup details)
+3. **Go 1.21+** - Required to build and run the server
+4. **fswatch** (optional) - For hot reload in dev mode, installed automatically by `just dev`
 
 ## Usage
 

justfile

@@ -2,9 +2,21 @@
 default: run
 
 # Build the binary
-build:
+build: ensure-deps
     go build -o birdseye .
 
+# Ensure required tools are installed
+ensure-deps:
+    #!/usr/bin/env bash
+    if ! command -v go &> /dev/null; then
+        echo "Installing Go..."
+        brew install go
+    fi
+    if ! command -v claude &> /dev/null; then
+        echo "Installing Claude Code..."
+        brew install claude-code
+    fi
+
 # Run the server and open browser
 run: build
     #!/usr/bin/env bash