gstack Studio

A visual desktop app for gstack — discover, run, and monitor AI agents without touching the CLI.

Built for everyone: developers, PMs, designers, and anyone working alongside AI-powered engineering teams.

Download · Features · Prerequisites · Getting Started · Contributing

📸 Screenshots

_{Dashboard — AI Browser status, Start/Stop/Restart, "What would you like to do?" guided tasks}	_{Agent Board — 40+ agents by phase, phase-coloured cards, click to copy or ▶ run in terminal}
_{Activity — searchable skill browser with live AI browser log stream, ▶ run any agent}	_{Browser Automation — Tasks (form-based), Terminal, and Script modes; 44 commands}
_{Settings — project folder, gstack location, AI coding tool picker, dark/light/system theme}	_{Command Palette (⌘K) — instant search across all pages and agents}

gstack Studio is a companion app for gstack. It does not replace gstack — it wraps it in a polished GUI so you can discover agents, copy slash commands, monitor the AI browser service, and review project history, all without memorising CLI commands.

You don't need to be a developer to use it. Product managers, designers, and founders can browse agents, understand what each one does, and trigger AI-powered workflows from a clean visual interface.

✨ Features

Page	What it does
Dashboard	AI Browser health with gradient status card, Start / Stop / Restart, "What would you like to do today?" guided task panel, quick action cards with outcome descriptions, workspace switcher
Agent Board	40+ AI agents organised by phase (Think → Plan → Build → Review → Test → Ship → Reflect) — phase-coloured left-accent cards, plain-English phase descriptions, audience badges, "What are phases?" explainer. Click any card to copy its `/command`; ▶ run directly in terminal
Activity	Searchable agent browser with phase filter + live AI browser log stream; per-agent doc viewer (renders SKILL.md) and ▶ run in terminal
Browser Automation	Three modes: Tasks (form-based, no syntax needed), Terminal (raw command input), Script (multi-line batch). Covers 44 browser commands across 7 categories
History	Per-project AI learnings with timeline design, full-text search, and export (JSON / Markdown), stored in `~/.gstack/projects/*/learnings.jsonl`
Settings	Project folder, gstack location, AI coding tool auto-detection (Claude Code / Codex / OpenClaw / Factory / Kiro), colour theme (dark / light / system), auto-start toggle, API keys

Designed for everyone

Non-coders: plain-English labels throughout, outcome-focused descriptions, guided task panel, form-based browser automation, labelled sidebar navigation
Developers: full terminal mode, script runner, command history, phase-organised agent grid, live log streaming, SKILL.md doc viewer
New users: onboarding wizard auto-installs gstack with one click, Bun check with clear install instructions, "What happens next" guidance after setup

Additional capabilities

Direct agent execution — ▶ Run button on every skill opens a real interactive terminal with claude /skill (or codex / OpenClaw / Factory / Kiro) — no copy-paste required
AI coding tool auto-detection — Settings scans common install paths and $PATH for all supported tools; click to select, custom path override available
First-launch onboarding wizard — guided 3-step setup with one-click gstack auto-install: if gstack isn't found, the Configure step clones it from GitHub automatically
Skill documentation viewer — reads each skill's SKILL.md and renders it inline (headings, bold, code blocks) with a Copy Command button
Auto-update — checks GitHub Releases on startup; shows a download banner in the title bar when a new version is available
Labelled navigation sidebar — every nav item shows its icon + text label (not icon-only), so the app is navigable without hover or prior knowledge
Custom window chrome (Windows / Linux) — native Min / Max / Close buttons integrated in the app title bar
Error boundary — each page catches React errors and shows a graceful fallback UI

What gstack Studio is NOT

It does not replace the Claude Code CLI — agents still run inside your chosen AI coding tool (Claude Code, Codex, etc.). The ▶ Run button simply opens a pre-filled terminal for you
It does not modify gstack in any way — zero changes to the gstack codebase (Layer 1 integration only)
It is not a standalone AI coding assistant

⬇️ Download

Pre-built binaries are attached to every GitHub Release.

Platform	Format	Download
macOS (Apple Silicon)	`.dmg`	Latest release →
macOS (Intel)	`.dmg`	Latest release →
Windows (x64)	`.exe` installer	Latest release →
Linux (x64)	`.AppImage` / `.deb`	Latest release →

Or build from source — see Development.

🔑 Prerequisites

Bun — required to run the AI browser service (curl -fsSL https://bun.sh/install | bash or brew install bun)
git — required if you want the onboarding wizard to auto-install gstack
An AI coding tool — Claude Code, Codex, OpenClaw, Factory, or Kiro (for running agents)
An Anthropic API key — optional, only needed if running agents programmatically via the API

gstack is required — without it there are no agents, no AI browser service, and no Browser Automation page. However, you don't need to install it before launching the app. If gstack isn't present, the onboarding wizard installs it for you with one click.

gstack Studio works on macOS, Windows, and Linux. The AI browser service requires Bun; the onboarding wizard checks for Bun and shows clear install instructions if it's missing.

🚀 Getting Started

1. Install gstack Studio

Download the installer for your platform from Releases and run it.

2. Configure your workspace

On first launch an onboarding wizard guides you through setup automatically.

If gstack is already installed, point the wizard to it.
If gstack is not installed yet, click "Install gstack automatically" — Studio will clone it from GitHub in the background and fill in the path for you.

You can also configure paths at any time in Settings:

Workspace Directory — the project folder where you run gstack (e.g. ~/my-project). The daemon will start from this directory.
gstack Install Path — where gstack is installed (default: ~/.claude/skills/gstack).
Anthropic API Key — optional, stored locally in ~/.gstack/studio-config.json.

3. Start the AI Browser

Go to Dashboard and click Start AI Browser. The status dot turns green when the service is live and agents can use the web.

4. Pick an agent and run it

Open the Agent Board, find any agent, and click its card to copy the command (e.g. /review). Paste it into Claude Code, or click ▶ to open a pre-filled terminal automatically.

Not sure where to start? The Dashboard shows a "What would you like to do today?" panel with 5 common starting tasks and plain-English descriptions.

🗺️ Roadmap

🛠️ Development

Stack

Electron 33 + electron-vite — app shell
React 18 + React Router v6 — renderer UI
Tailwind CSS v3 — styling
TypeScript throughout
electron-builder — cross-platform packaging

Setup

# Clone
git clone https://github.com/arunrajiah/gstack-studio.git
cd gstack-studio

# Install dependencies
npm install

# Start dev server (hot reload)
npm run dev

Build

# Type-check only
npm run typecheck

# Build all platforms (requires code signing certs for distribution)
npm run package

# Build for a specific platform
npm run package:mac
npm run package:win
npm run package:linux

Artifacts go to dist/.

Project layout

gstack-studio/
├── scripts/
│   └── generate-icon.mjs     # Pure Node.js app icon generator (no external deps)
├── build/
│   └── icon.png              # Generated 1024×1024 app icon
├── src/
│   ├── main/                 # Electron main process (Node.js)
│   │   ├── index.ts          # App bootstrap, BrowserWindow, auto-updater
│   │   ├── daemon.ts         # GStackDaemon — spawn/stop browse server
│   │   └── ipc.ts            # IPC handlers exposed to renderer
│   ├── preload/
│   │   └── index.ts          # contextBridge — exposes window.gstack API
│   └── renderer/
│       └── src/
│           ├── App.tsx       # Router + layout shell
│           ├── components/
│           │   ├── Layout.tsx        # App shell with onboarding gate
│           │   ├── Titlebar.tsx      # Drag bar + daemon pill + update banner
│           │   ├── WindowControls.tsx # Min/Max/Close (Windows/Linux only)
│           │   ├── Sidebar.tsx       # Navigation
│           │   ├── ErrorBoundary.tsx # Page-level error fallback
│           │   └── SkillDocModal.tsx # SKILL.md viewer modal
│           ├── lib/
│           │   ├── gstack-client.ts  # window.gstack typed wrapper
│           │   └── store.ts          # React hooks (useDaemon, useSkills, useConfig…)
│           └── pages/
│               ├── Onboarding.tsx    # First-launch 3-step setup wizard
│               ├── Dashboard.tsx
│               ├── Sprint.tsx
│               ├── Browse.tsx
│               ├── History.tsx
│               ├── Agents.tsx
│               └── Settings.tsx
├── .github/
│   ├── workflows/
│   │   └── build.yml   # CI: type-check on PR, release binaries on tag
│   └── ISSUE_TEMPLATE/
├── electron-builder.yml
├── electron.vite.config.ts
└── package.json

🤝 Contributing

We welcome contributions of all kinds — bug fixes, new features, docs improvements, and design feedback.

Please read CONTRIBUTING.md before opening a pull request.

Quick start:

# Fork → clone → branch
git checkout -b feat/your-feature

# Make changes, then
npm run typecheck   # must pass
npm run dev         # manual test

# Commit using Conventional Commits
git commit -m "feat: add agent filter by phase"

# Push and open a PR against main

🔗 Related

garrytan/gstack — the AI agent framework this app wraps (required — auto-installable via the onboarding wizard)
Anthropic Claude Code — the CLI where gstack agents actually run

📄 License

MIT — see LICENSE.

_{Built with ♥ as an open-source companion to gstack.}

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.github		.github
build		build
docs/screenshots		docs/screenshots
scripts		scripts
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
electron-builder.yml		electron-builder.yml
electron.vite.config.ts		electron.vite.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
tsconfig.web.json		tsconfig.web.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

gstack Studio

📸 Screenshots

✨ Features

Designed for everyone

Additional capabilities

What gstack Studio is NOT

⬇️ Download

🔑 Prerequisites

🚀 Getting Started

1. Install gstack Studio

2. Configure your workspace

3. Start the AI Browser

4. Pick an agent and run it

🗺️ Roadmap

🛠️ Development

Stack

Setup

Build

Project layout

🤝 Contributing

🔗 Related

📄 License

About

Uh oh!

Releases 8

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

gstack Studio

📸 Screenshots

✨ Features

Designed for everyone

Additional capabilities

What gstack Studio is NOT

⬇️ Download

🔑 Prerequisites

🚀 Getting Started

1. Install gstack Studio

2. Configure your workspace

3. Start the AI Browser

4. Pick an agent and run it

🗺️ Roadmap

🛠️ Development

Stack

Setup

Build

Project layout

🤝 Contributing

🔗 Related

📄 License

About

Topics

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 8

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages