CalvinBackup/gstack
1
0
Fork 0
mirror of https://github.com/garrytan/gstack.git synced 2026-07-15 20:17:24 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: built for Claude Code (works with any shell-capable agent)

Browse Source 
Lead messaging with Claude Code. Add note that Codex, Cursor, etc.
can also use it since it's just a CLI binary.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-03-11 15:58:23 -07:00
parent effb88ab66
commit cbb82390c7
3 changed files with 7 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+5 -3
View File
@@ -1,12 +1,12 @@
# gstack-browse # gstack-browse
**The browser tool that AI coding agents deserve.** Persistent headless Chromium daemon with ~100ms commands. No MCP. No Chrome extension. No bullshit. **The browser tool that Claude Code deserves.** Persistent headless Chromium daemon with ~100ms commands. No MCP. No Chrome extension. No bullshit.
Created by [Garry Tan](https://x.com/garrytan), President & CEO of [Y Combinator](https://www.ycombinator.com/). Created by [Garry Tan](https://x.com/garrytan), President & CEO of [Y Combinator](https://www.ycombinator.com/).
## The Problem ## The Problem
Every AI coding agent needs to browse the web. Check a deployment. Verify a UI change. Read documentation. Fill out a form. Take a screenshot. Simple stuff. Claude Code needs to browse the web. Check a deployment. Verify a UI change. Read documentation. Fill out a form. Take a screenshot. Simple stuff.
The existing solutions are all terrible: The existing solutions are all terrible:
@@ -53,9 +53,11 @@ Claude Code ──Bash──> browse CLI ──HTTP──> Bun server ──Play
**Crash recovery**: If Chromium crashes, the server exits. Next CLI call auto-starts a fresh one. No stale state. No zombie processes. No "have you tried restarting the extension?" **Crash recovery**: If Chromium crashes, the server exits. Next CLI call auto-starts a fresh one. No stale state. No zombie processes. No "have you tried restarting the extension?"
**Works with any agent**: Built for Claude Code, but any coding agent with shell access (Codex, Cursor, etc.) can call the CLI. It's just a binary that prints to stdout.
## What it can do ## What it can do
40+ commands covering everything an AI agent needs: 40+ commands covering everything Claude Code needs:
```bash ```bash
B=~/.claude/skills/gstack-browse/dist/browse B=~/.claude/skills/gstack-browse/dist/browse
SKILL.md
+1 -1
View File
@@ -2,7 +2,7 @@
name: gstack-browse name: gstack-browse
version: 0.1.0 version: 0.1.0
description: | description: |
Fast web browsing via persistent headless Chromium daemon. Navigate to any URL, Fast web browsing for Claude Code via persistent headless Chromium daemon. Navigate to any URL,
read page content, click elements, fill forms, run JavaScript, take screenshots, read page content, click elements, fill forms, run JavaScript, take screenshots,
inspect CSS/DOM, capture console/network logs, and more. ~100ms per command after inspect CSS/DOM, capture console/network logs, and more. ~100ms per command after
first call. Use when you need to check a website, verify a deployment, read docs, first call. Use when you need to check a website, verify a deployment, read docs,
package.json
+1 -1
View File
@@ -1,7 +1,7 @@
{ {
"name": "gstack-browse", "name": "gstack-browse",
"version": "0.1.0", "version": "0.1.0",
"description": "Fast headless browser CLI for AI coding agents. Persistent Chromium daemon with sub-200ms commands.", "description": "Fast headless browser for Claude Code. Persistent Chromium daemon, ~100ms commands, zero MCP overhead.",
"license": "MIT", "license": "MIT",
"type": "module", "type": "module",
"bin": { "bin": {