@jonchurch/claude-code-gh 0.1.2 → 1.1.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,15 +26,25 @@ 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
+### Local Install (Alternative)
 
-Your Claude Code environment needs **"Full"** network access, or **"Custom"** with `release-assets.githubusercontent.com` allowed. "Limited" won't work because GitHub release downloads redirect to that domain which isn't on the default allowlist.
+Running `npx` on every session start means executing code from npm that you don't control. If you'd rather call a script under your own version control:
+
+```bash
+npx @jonchurch/claude-code-gh install
+```
+
+This copies the script to `.claude/hooks/` and updates your settings to use it. Commit both and you're set.
+
+## Environment / Network Settings
+
+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.)
 
 ## Authentication
 
-To use `gh` with private repos or higher rate limits, add `GH_TOKEN` to your environment variables.
+For private repos or higher rate limits, add `GH_TOKEN` to your environment variables.
 
 ## License
 

package/bin/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const command = process.argv[2];
+
+if (command === 'install') {
+  install();
+} else {
+  // Default: run setup.sh
+  const setup = path.join(__dirname, 'setup.sh');
+  const child = spawn('bash', [setup], { stdio: 'inherit' });
+  child.on('close', code => process.exit(code));
+}
+
+function install() {
+  const HOOKS_DIR = '.claude/hooks';
+  const SETTINGS_PATH = '.claude/settings.json';
+  const SCRIPT_NAME = 'jonchurch-claude-code-gh.sh';
+
+  // Copy setup.sh to user's repo
+  const src = path.join(__dirname, 'setup.sh');
+  const dest = path.join(HOOKS_DIR, SCRIPT_NAME);
+
+  fs.mkdirSync(HOOKS_DIR, { recursive: true });
+  fs.copyFileSync(src, dest);
+  fs.chmodSync(dest, 0o755);
+  console.log(`Copied ${dest}`);
+
+  // Update settings.json
+  let settings = {};
+  if (fs.existsSync(SETTINGS_PATH)) {
+    settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'));
+  }
+
+  const hookCommand = `"$CLAUDE_PROJECT_DIR"/${HOOKS_DIR}/${SCRIPT_NAME}`;
+
+  // Check if already installed (look for our script name in any SessionStart hook)
+  const alreadyInstalled = settings.hooks?.SessionStart?.some(entry =>
+    entry.hooks?.some(h => h.command?.includes(SCRIPT_NAME))
+  );
+
+  if (alreadyInstalled) {
+    console.log('Hook already configured');
+  } else {
+    if (!settings.hooks) settings.hooks = {};
+    if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+
+    settings.hooks.SessionStart.push({
+      matcher: 'startup',
+      hooks: [{ type: 'command', command: hookCommand }]
+    });
+
+    fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
+    console.log(`Added hook to ${SETTINGS_PATH}`);
+  }
+
+  console.log('\nDone! Commit the changes:');
+  console.log(`  git add ${SETTINGS_PATH} ${dest}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jonchurch/claude-code-gh",
-  "version": "0.1.2",
+  "version": "1.1.0",
   "description": "Auto-install GitHub CLI (gh) for Claude Code web/remote sessions",
   "author": "Jon Church",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "web"
   ],
   "bin": {
-    "claude-code-gh": "bin/setup.sh"
+    "claude-code-gh": "bin/cli.js"
   },
   "files": [
     "bin"