Project Setup
Run gwt init in your repository root to configure gwt interactively.
The init wizard
gwt init
Setting up gwt for /path/to/project...
Project name: my-app
Gateway port: 54846
Add a gateway app? yes
App name: frontend
Command: npm run dev
Ready pattern: localhost
Add a gateway app? no
Install Claude Code hooks? yes
Writing .config/gwt.toml
Installed plugin to ~/.config/gwt/gwt.wasm
Done! Run `gwt attach` to start your session.
The wizard creates .config/gwt.toml in your project root. See the configuration reference for all available options.
What gets created
| File | Purpose |
|---|---|
.config/gwt.toml | Project configuration |
.gwt/ | Runtime state (PID files, logs) — gitignored |
.worktrees/ | Worktree directories — gitignored |
Diffity setup
If Node.js is available on your system, the gateway will automatically include the Diffity code review app. No extra configuration needed — gwt detects npx at runtime.
If you install Node.js later, Diffity will be available the next time you start the gateway. Run gwt doctor to check the current status.
Claude Code hooks
When you choose to install Claude Code hooks, gwt registers lifecycle hooks so that the AI agent is aware of worktree operations (branch switches, creates, removes). This enables the agent to react to your workflow automatically.