gh-here 1.0.0 → 1.0.2

package/.claude/settings.local.json

@@ -0,0 +1,21 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(if [ -f scripts/lint ])",
+      "Bash(then scripts/lint)",
+      "Bash(elif [ -f script/lint ])",
+      "Bash(then script/lint)",
+      "Bash(elif [ -f package.json ])",
+      "Bash(then npm run lint)",
+      "Bash(else echo \"No linting script found\")",
+      "Bash(fi)",
+      "Bash(git checkout:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(gh pr view:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/README.md

@@ -1,11 +1,23 @@
 # gh-here
 
-A local GitHub-like file browser for viewing code in your terminal. Launch it in any folder to get a beautiful web-based directory browser with syntax highlighting and powerful navigation features.
+A local GitHub-like file browser for viewing and exploring codebases in your browser. Launch it in any folder to get a beautiful web-based directory browser with syntax highlighting and powerful navigation features.
+
+## Why?
+
+TUIs (Terminal User Interfaces) like Claude Code, Google Gemini CLI, and Cursor are becoming very popular tools for working on codebases, but they don't provide a visual view into the directories and files themselves. gh-here exists to fill that gap, so you can easily explore your project files in a familiar GitHub-esque browser GUI.
 
 ## Installation
 
+Run gh-here directly with npx (no installation required):
+
+```bash
+npx gh-here
+```
+
+Or install it globally:
+
 ```bash
-npm install -g .
+npm install -g gh-here
 ```
 
 ## Usage
@@ -13,10 +25,10 @@ npm install -g .
 Navigate to any directory and run:
 
 ```bash
-npx gh-here                           # Start server on available port
-npx gh-here --open                    # Start server and open browser
-npx gh-here --open --browser=safari   # Start server and open in Safari
-npx gh-here --open --browser=arc      # Start server and open in Arc
+gh-here                           # Start server on available port
+gh-here --open                    # Start server and open browser
+gh-here --open --browser=safari   # Start server and open in Safari
+gh-here --open --browser=arc      # Start server and open in Arc
 ```
 
 The app will automatically find an available port starting from 3000 and serve your current directory with a GitHub-like interface.

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "gh-here",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A local GitHub-like file browser for viewing code",
+  "repository": "https://github.com/corywilkerson/gh-here",
   "main": "index.js",
   "bin": {
     "gh-here": "./bin/gh-here.js"
   },
   "scripts": {
-    "start": "node bin/gh-here.js"
+    "start": "node bin/gh-here.js",
+    "test": "echo yolo no tests yet"
   },
-  "keywords": ["github", "file-browser", "code-viewer", "local"],
+  "keywords": [
+    "github",
+    "file-browser",
+    "code-viewer",
+    "local"
+  ],
   "author": "",
   "license": "MIT",
   "dependencies": {
@@ -18,4 +25,4 @@
     "marked": "^12.0.0",
     "@primer/octicons": "^19.8.0"
   }
-}
+}

package/public/app.js

@@ -35,11 +35,28 @@ document.addEventListener('DOMContentLoaded', function() {
   // Initialize
   updateFileRows();
   
-  // Load saved theme or default to dark
-  const savedTheme = localStorage.getItem('gh-here-theme') || 'dark';
+  // Detect system theme preference
+  const systemPrefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+  const systemTheme = systemPrefersDark ? 'dark' : 'light';
+  
+  // Load saved theme or default to system preference
+  const savedTheme = localStorage.getItem('gh-here-theme') || systemTheme;
   html.setAttribute('data-theme', savedTheme);
   updateThemeIcon(savedTheme);
   
+  // Listen for system theme changes (only if no manual override is saved)
+  if (window.matchMedia) {
+    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
+    mediaQuery.addListener(function(e) {
+      // Only auto-update if user hasn't manually set a theme
+      if (!localStorage.getItem('gh-here-theme')) {
+        const newTheme = e.matches ? 'dark' : 'light';
+        html.setAttribute('data-theme', newTheme);
+        updateThemeIcon(newTheme);
+      }
+    });
+  }
+  
   // Theme toggle functionality
   themeToggle.addEventListener('click', function() {
     const currentTheme = html.getAttribute('data-theme');