Commit Graph

17 Commits

Author SHA1 Message Date
Garry Tan 16a2fb1abe docs: worktree + submodule support, project vs user-level paths
SKILL.md now checks project-level (.claude/skills/) first, then
user-level (~/.claude/skills/). Auto-detects uninitialized submodules
and runs git submodule update --init. README explains worktree behavior.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 16:01:08 -07:00
Garry Tan 8499173120 docs: simplify install — just clone, Claude handles setup
No manual bun install or build step. SKILL.md auto-detects missing
binary and handles setup on first use.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:59:21 -07:00
Garry Tan cbb82390c7 docs: built for Claude Code (works with any shell-capable agent)
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>
2026-03-11 15:58:23 -07:00
Garry Tan effb88ab66 fix: version 0.1.0 (not 2.0.0)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:57:13 -07:00
Garry Tan 0b68c0a798 fix: remove Conductor dependency from SKILL.md
Use plain text ask + wait instead of mcp__conductor__AskUserQuestion.
Makes the skill portable — works with any Claude Code setup, no MCP needed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:56:03 -07:00
Garry Tan 857436f40b feat: auto-setup on first use via AskUserQuestion
SKILL.md now instructs Claude to check if the binary exists before
any browse command. If missing, asks user permission to run setup
(bun install + build). One-time ~10s setup, then never again.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:55:32 -07:00
Garry Tan d5233f4db0 docs: rewrite README — why MCP sucks, why gstack-browse exists
Full teardown of Chrome MCP, Playwright MCP, and MCP protocol overhead.
Performance comparison table. Complete command reference and install guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:50:08 -07:00
Garry Tan 76b7cab27b Merge pull request #1 from garrytan/garrytan/run-tests-info
docs: add README and CLAUDE.md
2026-03-11 15:27:20 -07:00
Garry Tan 1694a87113 docs: add README and CLAUDE.md
README with open source install instructions (project-level and user-level),
copy-paste CLAUDE.md snippet for users, command reference, and architecture.
CLAUDE.md with dev workflow for contributors.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:18:59 -07:00
Garry Tan e9c1ec427a chore: remove accidental build artifact, ignore *.bun-build
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:26:00 -07:00
Garry Tan 510bc4782a chore: rename skill from browse to gstack-browse
Update all paths from ~/.claude/skills/browse/ to
~/.claude/skills/gstack-browse/ in SKILL.md and cli.ts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:25:09 -07:00
Garry Tan 63bd25ed88 chore: ignore bun.lock
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:23:45 -07:00
Garry Tan ed758169c0 docs: Claude Code skill definition (SKILL.md)
Teaches Claude Code how to use the browse tool: command reference,
speed rules, decision table, multi-step workflow examples, and
architecture overview.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:23:45 -07:00
Garry Tan 27b28b048d test: 40 integration tests with fixture server
Tests all commands against local Bun test server serving HTML fixtures.
Covers navigation, content extraction, JS/CSS inspection, form interaction,
SPA rendering, console/network buffers, tabs, screenshots, responsive,
diff, chain, and storage.

40 pass, 0 fail, 2s runtime.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:23:45 -07:00
Garry Tan 9e03049de1 feat: 40+ browser commands (read, write, meta)
Read: text, html, links, forms, accessibility, js, eval, css, attrs,
console, network, cookies, storage, perf
Write: goto, back, forward, reload, click, fill, select, hover, type,
press, scroll, wait, viewport, cookie, header, useragent
Meta: tabs, tab, newtab, closetab, status, url, stop, restart,
screenshot, pdf, responsive, chain, diff

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:23:45 -07:00
Garry Tan 564599e58b feat: persistent Chromium daemon with CLI wrapper
Bun-powered HTTP server on localhost keeps headless Chromium alive
between commands. CLI auto-starts server on first call (~3s), subsequent
commands ~100-200ms. Bearer token auth, 30 min idle shutdown, auto-restart
on Chromium crash.

Architecture: compiled CLI binary → HTTP POST → Bun.serve → Playwright

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 14:23:44 -07:00
Garry Tan 3b79ca5684 Initial commit 2026-03-11 14:22:45 -07:00