@jonchurch/claude-code-gh 0.1.1 → 1.0.0

package/README.md

@@ -1,12 +1,12 @@
 # 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.
+Claude Code web sessions run on ephemeral VMs without the GitHub CLI (`gh`). If you're used to having Claude work with `gh` locally, you won't be able to in 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.
+This package fixes that by installing `gh` automatically [when your session starts](https://code.claude.com/docs/en/hooks#sessionstart).
 
 ## Setup
 
-Add to your repo's `.claude/settings.json` (not user level `~/.claude/settings.json` because remote sessions only see repo-level settings):
+Remote sessions only see repo-level settings. Add to `.claude/settings.json` in your repo:
 
 ```json
 {
@@ -26,13 +26,15 @@ Add to your repo's `.claude/settings.json` (not user level `~/.claude/settings.j
 }
 ```
 
-Commit that file and `gh` will be available in your next web session.
+Commit and `gh` will be available in your next web session.
 
-## Environment
+## Environment / Network Settings
 
-Your Claude Code environment needs "Limited" (default) or "Full" network access. "No internet" mode will fail since we need to reach GitHub.
+Requires **"Full"** [network access](https://code.claude.com/docs/en/claude-code-on-the-web), or **"Custom"** with `release-assets.githubusercontent.com` allowed. ("Limited" won't work - GitHub downloads redirect to that domain.)
 
-To authenticate `gh` for private repos or higher rate limits, add `GH_TOKEN` to your environment variables in the Claude web app settings.
+## Authentication
+
+For private repos or higher rate limits, add `GH_TOKEN` to your environment variables.
 
 ## License
 

package/bin/setup.sh

@@ -2,7 +2,6 @@
 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
 
@@ -14,14 +13,15 @@ export PATH="$LOCAL_BIN:$PATH"
 
 if command -v gh &>/dev/null; then
     log "gh already available"
-    context "GitHub CLI available: $(gh --version | head -1)"
+    echo "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."
+if ! curl -sL --connect-timeout 5 -o /dev/null https://release-assets.githubusercontent.com 2>/dev/null; then
+    log "Cannot download gh CLI: release-assets.githubusercontent.com is not reachable."
+    log "Fix: Use 'Full' network access, or add release-assets.githubusercontent.com to your Custom allowlist."
     exit 2
 fi
 
@@ -36,10 +36,8 @@ case "$ARCH" in
     *) 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; }
+RELEASE_JSON=$(curl -sL --retry 2 "https://api.github.com/repos/cli/cli/releases/latest") || { log "Failed to 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
@@ -54,9 +52,9 @@ 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; }
+TAR_URL="https://github.com/cli/cli/releases/download/v${VERSION}/${TAR_NAME}.tar.gz"
 
+curl -sL --retry 2 "$TAR_URL" | tar -xz -C "$TEMP_DIR" || { log "Failed to download/extract gh CLI"; exit 2; }
 
 ### -------- mv the binary to local bin
 
@@ -64,4 +62,4 @@ 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"
+echo "GitHub CLI installed: $(gh --version | head -1) - use gh for GitHub operations"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonchurch/claude-code-gh",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Auto-install GitHub CLI (gh) for Claude Code web/remote sessions",
   "author": "Jon Church",
   "license": "MIT",