@jonchurch/claude-code-gh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2026 Jon Church
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# claude-code-gh
+
+Claude Code web sessions run on ephemeral VMs that don't have the GitHub CLI (`gh`) installed. This means that if you're used to having claude work with the `gh` cli locally for interacting with Github, you are not able to in Claude Code web sessions.
+
+This package provides a [SessionStart hook](https://code.claude.com/docs/en/hooks#sessionstart) that installs the latest `gh` automatically when your session starts. Hooks are scripts that Claude Code runs at specific points - SessionStart hooks run once when a new session begins, making them perfect for environment setup.
+
+## Setup
+
+Add to your repo's `.claude/settings.json` (not user level `~/.claude/settings.json` because remote sessions only see repo-level settings):
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx @jonchurch/claude-code-gh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Commit that file and `gh` will be available in your next web session.
+
+## Environment
+
+Your Claude Code environment needs "Limited" (default) or "Full" network access. "No internet" mode will fail since we need to reach GitHub.
+
+To authenticate `gh` for private repos or higher rate limits, add `GH_TOKEN` to your environment variables in the Claude web app settings.
+
+## License
+
+MIT

package/bin/setup.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+set -eo pipefail
+
+log() { echo "[claude-code-gh] $1" >&2; }
+context() { echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SessionStart\",\"additionalContext\":\"$1\"}}"; }
+
+### -------- check if we need to install the cli
+
+[[ "$CLAUDE_CODE_REMOTE" == "true" ]] || { log "Not remote, skipping"; exit 0; }
+
+LOCAL_BIN="$HOME/.local/bin"
+mkdir -p "$LOCAL_BIN"
+export PATH="$LOCAL_BIN:$PATH"
+
+if command -v gh &>/dev/null; then
+    log "gh already available"
+    context "GitHub CLI available: $(gh --version | head -1)"
+    exit 0
+fi
+
+### -------- check network access
+
+if ! curl -sL --connect-timeout 5 -o /dev/null https://api.github.com 2>/dev/null; then
+    log "Failed to install gh CLI: cannot reach GitHub API. Network may be restricted - configure 'Limited' or 'Full' network access in your Claude Code environment settings."
+    exit 2
+fi
+
+### -------- prepare to install CLI
+
+log "Installing gh CLI..."
+
+ARCH=$(uname -m)
+case "$ARCH" in
+    x86_64) GH_ARCH="amd64" ;;
+    aarch64|arm64) GH_ARCH="arm64" ;;
+    *) log "Failed to install gh CLI: unsupported architecture '$ARCH'. Only x86_64 and arm64 are supported."; exit 2 ;;
+esac
+
+log "Detected arch $ARCH"
+
+# Fetch latest version from GitHub API
+RELEASE_JSON=$(curl -sL "https://api.github.com/repos/cli/cli/releases/latest") || { log "Failed to install gh CLI: could not fetch release info from GitHub API."; exit 2; }
+if command -v jq &>/dev/null; then
+    VERSION=$(echo "$RELEASE_JSON" | jq -r '.tag_name | ltrimstr("v")')
+else
+    VERSION=$(echo "$RELEASE_JSON" | sed -n 's/.*"tag_name": *"v\([^"]*\)".*/\1/p' | head -1)
+fi
+[[ -n "$VERSION" && "$VERSION" != "null" ]] || { log "Failed to install gh CLI: could not parse version from GitHub API response."; exit 2; }
+
+log "Downloading v$VERSION..."
+TEMP_DIR=$(mktemp -d)
+trap 'rm -rf "$TEMP_DIR"' EXIT
+
+### -------- fetch and unpack the tarball
+
+TAR_NAME="gh_${VERSION}_linux_${GH_ARCH}"
+curl -sL "https://github.com/cli/cli/releases/download/v${VERSION}/${TAR_NAME}.tar.gz" \
+    | tar -xz -C "$TEMP_DIR" || { log "Failed to install gh CLI: could not download or extract release tarball."; exit 2; }
+
+
+### -------- mv the binary to local bin
+
+mv "$TEMP_DIR/${TAR_NAME}/bin/gh" "$LOCAL_BIN/" && chmod +x "$LOCAL_BIN/gh"
+[[ -n "$CLAUDE_ENV_FILE" ]] && echo "export PATH=\"$LOCAL_BIN:\$PATH\"" >> "$CLAUDE_ENV_FILE"
+
+log "Installed $(gh --version | head -1)"
+context "GitHub CLI installed: $(gh --version | head -1) use gh for github operations"

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@jonchurch/claude-code-gh",
+  "version": "0.1.0",
+  "description": "Auto-install GitHub CLI (gh) for Claude Code web/remote sessions",
+  "author": "Jon Church",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jonchurch/claude-code-gh.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jonchurch/claude-code-gh/issues"
+  },
+  "homepage": "https://github.com/jonchurch/claude-code-gh#readme",
+  "keywords": [
+    "anthropic",
+    "claude",
+    "claude-code",
+    "gh",
+    "github-cli",
+    "remote",
+    "session-hook",
+    "web"
+  ],
+  "bin": {
+    "claude-code-gh": "bin/setup.sh"
+  },
+  "files": [
+    "bin"
+  ]
+}