From 26b74d1e157fc80a5221b9fc12e97028258a3fc6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 2 Jul 2026 11:27:32 +0000
Subject: [PATCH] chore: add SessionStart hook to activate repo for Claude Code
 on the web

Installs project dependencies via 'uv sync --all-extras --frozen' (mirroring
CI) at the start of every web session, so tests (pytest) and the linter (ruff)
are ready without manual setup. Guarded to run only in the remote environment,
and idempotent/non-interactive. .gitignore is updated to track the shared hook
and settings while keeping other local .claude/ state ignored.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q6nPqmDrQ5F7GZgebHfXKk
---
 .claude/hooks/session-start.sh | 23 +++++++++++++++++++++++
 .claude/settings.json          | 14 ++++++++++++++
 .gitignore                     |  7 +++++++
 3 files changed, 44 insertions(+)
 create mode 100755 .claude/hooks/session-start.sh
 create mode 100644 .claude/settings.json

diff --git a/.claude/hooks/session-start.sh b/.claude/hooks/session-start.sh
new file mode 100755
index 000000000..59319b0c9
--- /dev/null
+++ b/.claude/hooks/session-start.sh
@@ -0,0 +1,23 @@
+#!/bin/bash
+# SessionStart hook: install dependencies so tests and linters work in
+# Claude Code on the web sessions. Idempotent and non-interactive.
+set -euo pipefail
+
+# Only run in the remote (Claude Code on the web) environment; local sessions
+# manage their own virtualenv.
+if [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
+  exit 0
+fi
+
+cd "$CLAUDE_PROJECT_DIR"
+
+# Install uv if it isn't already on PATH (the remote image may not ship it).
+if ! command -v uv >/dev/null 2>&1; then
+  curl -LsSf https://astral.sh/uv/install.sh | sh
+  export PATH="$HOME/.local/bin:$PATH"
+  echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$CLAUDE_ENV_FILE"
+fi
+
+# --frozen installs straight from the committed uv.lock without re-resolving or
+# rewriting it (mirrors CI). --all-extras pulls in the dev tools (pytest, ruff).
+uv sync --all-extras --frozen
diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 000000000..e06b0338e
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/.gitignore b/.gitignore
index 0a6775b2a..73267c09a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,13 @@ graphify-out/
 .graphify_*.json
 .graphify_python
 .claude/
+# Track the shared SessionStart hook and its settings (activates the repo for
+# Claude Code on the web); keep all other local .claude/ state ignored.
+!.claude/
+.claude/*
+!.claude/hooks/
+!.claude/hooks/session-start.sh
+!.claude/settings.json
 skills/
 # The packaged skill bundles under graphify/skills/ are generated, committed
 # artifacts (rendered by tools/skillgen). Keep them tracked even though the