gh-here 2.1.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.local.json +20 -11
- package/README.md +30 -101
- package/lib/constants.js +38 -0
- package/lib/error-handler.js +55 -0
- package/lib/file-tree-builder.js +81 -0
- package/lib/file-utils.js +43 -12
- package/lib/renderers.js +423 -194
- package/lib/server.js +120 -32
- package/lib/validation.js +77 -0
- package/package.json +1 -1
- package/public/app.js +199 -1825
- package/public/app.js.backup +1902 -0
- package/public/js/clipboard-utils.js +45 -0
- package/public/js/constants.js +60 -0
- package/public/js/draft-manager.js +36 -0
- package/public/js/editor-manager.js +159 -0
- package/public/js/file-tree.js +321 -0
- package/public/js/keyboard-handler.js +41 -0
- package/public/js/modal-manager.js +70 -0
- package/public/js/navigation.js +254 -0
- package/public/js/notification.js +23 -0
- package/public/js/search-handler.js +238 -0
- package/public/js/theme-manager.js +108 -0
- package/public/js/utils.js +123 -0
- package/public/styles.css +874 -570
- package/.channels_cache_v2.json +0 -10882
- package/.users_cache.json +0 -16187
- package/blog-post.md +0 -100
package/blog-post.md
DELETED
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
# Why gh-here is the Perfect Tool for Terminal-Heavy Developers
|
|
2
|
-
|
|
3
|
-
If you're like most developers in 2025, you probably spend a lot of time in the terminal. You're using Claude Code to generate and refactor code, running commands left and right, and iterating quickly on projects that haven't even been pushed to GitHub yet. But sometimes you need to step back and get a bird's-eye view of your codebase—and that's where `gh-here` shines.
|
|
4
|
-
|
|
5
|
-
## The Gap Between Terminal and IDE
|
|
6
|
-
|
|
7
|
-
Picture this scenario: You're deep in a terminal session, using Claude Code to implement a new feature. You've got files scattered across multiple directories, you're testing things with curl, and you're in that flow state where opening a heavy IDE would just break your momentum. But you need to:
|
|
8
|
-
|
|
9
|
-
- Quickly browse through your project structure
|
|
10
|
-
- Check what files you've modified
|
|
11
|
-
- Preview a README or markdown file
|
|
12
|
-
- Navigate between related files without losing context
|
|
13
|
-
- See language distribution across your codebase
|
|
14
|
-
|
|
15
|
-
This is the exact gap that `gh-here` fills.
|
|
16
|
-
|
|
17
|
-
## Built for Modern Development Workflows
|
|
18
|
-
|
|
19
|
-
### 1. **Perfect for AI-Assisted Development**
|
|
20
|
-
When you're working with Claude Code or GitHub Copilot, you're often generating and modifying files rapidly. `gh-here` gives you an instant, GitHub-like interface to review what's been changed without committing to version control or opening a full IDE.
|
|
21
|
-
|
|
22
|
-
### 2. **Ideal for Pre-Push Workflows**
|
|
23
|
-
Not everything needs to hit GitHub immediately. Whether you're experimenting with a proof of concept or working on a feature branch, `gh-here` lets you navigate and review your local changes in a familiar, web-based interface.
|
|
24
|
-
|
|
25
|
-
### 3. **Terminal-Native but GUI-Friendly**
|
|
26
|
-
Launch it with a single command (`gh-here`) from any directory, and instantly get a clean, GitHub-inspired interface in your browser. No configuration, no setup—just point and browse.
|
|
27
|
-
|
|
28
|
-
## Real-World Use Cases
|
|
29
|
-
|
|
30
|
-
**Scenario 1: Code Review Before Push**
|
|
31
|
-
```bash
|
|
32
|
-
$ claude "implement user authentication system"
|
|
33
|
-
# ... lots of generated files and changes
|
|
34
|
-
$ gh-here
|
|
35
|
-
# Browse through generated files, check git status, review changes
|
|
36
|
-
$ git add . && git commit -m "Add user authentication"
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
**Scenario 2: Project Exploration**
|
|
40
|
-
```bash
|
|
41
|
-
$ git clone some-interesting-repo
|
|
42
|
-
$ cd some-interesting-repo
|
|
43
|
-
$ gh-here
|
|
44
|
-
# Instantly get an overview: languages used, file structure, README preview
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
**Scenario 3: Documentation Review**
|
|
48
|
-
```bash
|
|
49
|
-
$ claude "update all the documentation"
|
|
50
|
-
$ gh-here
|
|
51
|
-
# Preview all the markdown files in GitHub-style rendering
|
|
52
|
-
# Check if everything looks good before committing
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## Why Not Just Use GitHub or an IDE?
|
|
56
|
-
|
|
57
|
-
**GitHub**: Your code isn't pushed yet, or you're working on experimental changes you don't want in version control.
|
|
58
|
-
|
|
59
|
-
**IDE**: Too heavy for quick browsing, breaks your terminal flow, takes time to open and index.
|
|
60
|
-
|
|
61
|
-
**File Explorer**: No syntax highlighting, no git integration, no markdown rendering, no language stats.
|
|
62
|
-
|
|
63
|
-
**Terminal**: Great for editing, terrible for browsing and getting visual context.
|
|
64
|
-
|
|
65
|
-
## The Sweet Spot
|
|
66
|
-
|
|
67
|
-
`gh-here` hits the perfect sweet spot:
|
|
68
|
-
- **Lightweight**: Starts instantly, no heavy indexing
|
|
69
|
-
- **Familiar**: GitHub-style interface that every developer knows
|
|
70
|
-
- **Integrated**: Shows git status, handles various file types, renders markdown
|
|
71
|
-
- **Flexible**: Works with any directory, whether it's a git repo or not
|
|
72
|
-
- **Terminal-friendly**: Launch with one command, works alongside your existing workflow
|
|
73
|
-
|
|
74
|
-
## Features That Just Make Sense
|
|
75
|
-
|
|
76
|
-
- **Language statistics**: Instantly see what technologies your project uses
|
|
77
|
-
- **Git integration**: Visual git status indicators, diff viewing
|
|
78
|
-
- **File type support**: Syntax highlighting, image viewing, markdown rendering
|
|
79
|
-
- **Search functionality**: Quick file search with keyboard shortcuts
|
|
80
|
-
- **Breadcrumb navigation**: Always know where you are in your project
|
|
81
|
-
|
|
82
|
-
## Perfect for 2025 Development
|
|
83
|
-
|
|
84
|
-
As development workflows become more AI-assisted and terminal-centric, tools like `gh-here` become essential. You're not always in an IDE, you're not always ready to push to GitHub, but you always need to understand your codebase structure and changes.
|
|
85
|
-
|
|
86
|
-
It's the missing link between your terminal workflow and the visual context you need to stay productive.
|
|
87
|
-
|
|
88
|
-
## Get Started
|
|
89
|
-
|
|
90
|
-
```bash
|
|
91
|
-
npm install -g gh-here
|
|
92
|
-
cd your-project
|
|
93
|
-
gh-here
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
That's it. Your local codebase is now browsable in a clean, GitHub-style interface at `localhost:5556`.
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
*Built for developers who live in the terminal but occasionally need a better view of their code.*
|