Getting Started

Run Locally

Build the stable binary:

zig build
.\zig-out\bin\zigshell.exe

Build the DEV binary:

zig build dev
.\zig-out\bin\zigshell-dev.exe

Stable and DEV use separate session files so experiments can be tested without damaging the normal workspace.

First Workflow

1. Start ZigShell.
2. Use Ctrl+Shift+1 for a local CMD tab or Ctrl+Shift+3 for a Contabo UK tmux tab.
3. Use Ctrl+K to switch sessions, open workspace actions, or run ZigShell commands.
4. Use Ctrl+Shift+O to open or reconnect the browser pane for the current shell.
5. In a shell with zsb available, use zsb navigate "https://example.com" to drive the docked browser pane.

Files ZigShell Uses

ZigShell stores runtime state under %APPDATA%\ZigShell.

File	Purpose
session.json	Stable default workspace sessions
session-dev.json	DEV sessions
session-{id}.json	Named workspace sessions
windows.json	Stable workspace registry
windows-dev.json	DEV workspace registry
inbox-*.json	Live cross-window inbox snapshots
panewin-*.txt	Browser pane binding for zsb
browserwin-*.txt	Edge window id binding

Deployment Note

These docs are an Astro 7 + Starlight site. The Cloudflare Pages build command is:

cd docs-site
npm run build
wrangler pages deploy dist --project-name zigshell-docs