What is GetWebstack?

GetWebstack creates isolated production-parity environments for full-stack applications.

• Parallel AI testing: Run AI agents on your codebase simultaneously in isolated, production-like environments.
• Full-stack support: Includes frontends, APIs, and dependencies like databases, queues, caches, and more.
• Full privacy: Your code runs locally. You keep full control.

---

The Problem

AI agents and developers can't test full-stack applications properly:

• AI agents write code blindly - No way to deploy and test in real environments before review
• Shared environments cause conflicts - Multiple agents and developers can't work in parallel safely

Result: AI-generated code looks correct but breaks in production. Hours wasted debugging.

---

The Solution

GetWebstack gives you a production-like environment locally in one command: gws up

This creates:

• Local cluster (starts in 15s)
• Isolated namespaces for each environment
• Running databases and services
• Real DNS with HTTPS (*.local.getwebstack.dev)
• Bidirectional file sync (see changes in ~0.5s)
• Git worktree isolation for parallel AI agents

Your code never leaves your machine. No Git access required. Full privacy.

---

Who Should Use GetWebstack?

Developers Building Full-Stack Apps Test frontend, backend, and database interactions locally in production-like environments. Catch integration issues early.

Teams Reviewing PRs Deploy each PR in its own isolated environment. Test changes safely without affecting other developers.

Developers Using AI Agents Let AI agents deploy and test their changes in real environments before you review them. Each agent works in isolation.

Privacy-Conscious Teams Keep sensitive code on your infrastructure. No cloud dependencies. No Git access required. Works completely offline.

---

Fast set-up

# Install
curl -sSL https://getwebstack.com/install.sh | bash

# Authenticate
gws login

# Initialize the project shell
cd your-project
gws init

# Have your AI agent generate gws.json + manifests + deploy
# (in Claude Code / Copilot CLI / Codex / Cursor / Amp)
/gws-setup

# Access your app
open https://myapp.local.getwebstack.dev

Time to first deployment: < 5 minutes

No AI agent? Hand-author gws.json, then gws config import gws.json && gws up. See Zero-Config Setup with AI.

---

AI Agent environment

# Human creates an isolated worktree for the AI agent
gws fork feature-payments
cd .worktrees/feature-payments

# Hand it off to your AI agent (Claude Code / Codex / Cursor / Copilot / Amp).
# Inside the agent:
#   /gws-setup         # generates gws.json + manifests on first run
#   gws up -w feature-payments
#
# The AI then:
#   1. Implements the Stripe payment integration
#   2. Tests:  curl -b 'gws-namespace=<deploymentId>' https://api.<project>.local.getwebstack.dev/checkout
#   3. Iterates until tests pass (uses /gws-debug on failure)
#   4. Reports: "Payment integration complete. Tests passing ✓"

# Human reviews tested code
git diff main

# Merge when satisfied
git merge feature-payments

Worktrees in Action:

project/
├── main/                           # Your main codebase
├── .worktrees/
│   ├── feature-payments/           # Agent 1 works here (isolated)
│   ├── feature-auth/               # Agent 2 works here (isolated)
│   └── bug-fix-login/              # Agent 3 works here (isolated)

Each worktree gets its own:

• Directory with full code copy
• Git branch
• Isolated namespace (myapp-feature-payments)
• Isolated databases and services
• Cookie-scoped routing (same hostnames as main; the gws-namespace cookie picks the fork)

---

Architecture

GetWebstack combines five technologies:

Technology	Purpose
Local container cluster	Production-like runtime in Docker (15s startup)
Git worktrees	Isolated code copies for parallel work
Namespaces	Complete environment isolation per worktree
File sync	Bidirectional sync (~0.5s) via gws-file-sync
Gateway API	Zero-config DNS + routing

Your Laptop                   Local Cluster
───────────                   ─────────────
./api/         ←─sync→        namespace: myapp
./frontend/                   ├── api-pod
./database/                   ├── frontend-pod
                              └── postgres-pod
                                      ↓
                              Gateway (port-forward)
                                      ↓
                              *.myapp.local.getwebstack.dev

---

What Makes GetWebstack Different?

🔒 Privacy First Your code runs locally. No Git access required. No cloud dependencies.

🤖 AI Agent Native Built for humans and AI agents. Instructions auto-injected. Parallel worktrees for multiple agents.

🎯 Production-Like from Day One Real production-parity infrastructure in development. Catch bugs before staging. No more "works on my machine."

🚀 Zero Manual Setup gws up handles everything: cluster, images, DNS, TLS, sync, routing. No config needed.

	GetWebstack	DevPod/Coder	Ona (Gitpod)	CodeSandbox	DevSpace	Okteto	Tilt	Garden
Runs locally	✅	⚠️ Optional	❌	❌	✅	⚠️ Optional	✅	✅
Full privacy	✅	⚠️ Optional	❌	❌	✅	❌	✅	✅
No Git access needed	✅	❌	❌	❌	✅	❌	✅	✅
Namespace isolation	✅	❌	❌	❌	⚠️ Manual	✅	⚠️ Manual	⚠️ Manual
Zero config	✅	❌	✅	✅	❌	⚠️ Some	❌	❌
AI agent support	✅ Built-in	⚠️ Manual	✅	✅	❌	❌	❌	❌
Parallel environments	✅ Worktrees	❌	❌	❌	⚠️ Manual	✅	⚠️ Manual	⚠️ Manual
Full-stack testing	✅	❌	⚠️ Single service	⚠️ Limited	✅	✅	✅	✅