Documentation

Rig is a macOS desktop app that manages your local JavaScript and TypeScript projects - Node, Bun, and Deno. It discovers projects, runs their dev servers, routes project.rig domains, and exposes everything through a CLI built for AI agents.

How it works

You add a folder. Rig watches it, finds every project with a package.json or deno.json, and detects the framework and package manager. Each project gets a stable port and a .rig URL. Start a project and Rig runs its dev command, captures the logs, and proxies the hostname to the running process.

Two ways to drive it

  • The app - a native window with a project sidebar, live logs, lifecycle controls, and a system tray.
  • The CLI - rig mirrors the GUI and emits JSON when piped, so scripts and AI agents can control your stack.

Start here

Next: Install & setup