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/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.*