macOS · Node · Bun · Deno

Local dev servers and AI debugging, handled.

Add a folder. Rig discovers every JavaScript and TypeScript project inside, detects the framework, assigns a port, and routes project.rig to the right process. The rig CLI gives any AI agent structured access to it all.

Requires macOS 12 or later · Apple Silicon & Intel

rig - zsh

Effortless dev servers

Stop juggling terminal tabs and clashing ports. Rig watches your folders, finds every project, and starts the right dev command on demand, with stable ports and clean, named .rig URLs.

  • Auto-discovery as you add and remove projects
  • Per-project port and Node version, stable across reboots
  • Start, stop, restart from the GUI, tray, or CLI

First-class AI debugging

The rig CLI emits raw JSON when piped, never ANSI noise. An agent can list projects, read live logs, restart a crashed server, and free a stuck port. It drives your whole dev environment on its own.

  • Structured JSON output, TTY-aware
  • rig logs --follow streams in real time
  • Installable skill so any agent learns the CLI
The app

A native window for your whole stack

This is the real Rig interface. Select a project, start and stop it, and watch the status and logs respond. Try it.

acme-storefront

Next
URLhttps://acme-storefront.rigPort:3001Node22PID48213Memory312.4 MB
Following · 10 / 10
14:32:06.044Started acme-storefront with pnpm run dev
14:32:08.181▲ Next.js 15.1.0
14:32:10.318- Local: http://localhost:3001
14:32:12.455- Network: https://acme-storefront.rig
14:32:14.592✓ Ready in 1.2s
14:32:16.729○ Compiling / ...
14:32:18.866✓ Compiled / in 643ms (1204 modules)
14:32:20.003GET / 200 in 51ms
14:32:22.140GET /products 200 in 88ms
14:32:24.277GET /api/cart 200 in 12ms
DNS :5300ProxyHelper :802 runningRig 0.1.0

Live mockup. Interactions are simulated.

Features

Everything the local stack needs

Discovery, routing, process control, and health checks, all built into one tool that stays out of your way.

Automatic discovery

Point Rig at a folder. It watches for package.json and deno.json, finds every project inside, and keeps the list live as you add or remove them.

Framework detection

Next, Nest, Vite, Nuxt, Astro, Remix, CRA, Fresh and more, detected from your manifest, with the right dev command resolved per project.

.rig domains

Every project gets projectname.rig, served on port 80. An embedded DNS server on 5300 means zero conflict with anything already using port 53.

Reverse proxy

A built-in axum proxy routes hostnames to the right running port, with branded error pages when a project is stopped or still starting.

Process management

Start, stop, and restart dev servers on demand. Crashes are caught and surfaced; ports stay stable across restarts and reboots.

Live logs

Per-project stdout and stderr, captured and streamed. Tail them in the GUI or pipe them to an AI agent with rig logs --follow.

Per-project HTTPS

Flip the lock to serve a project over HTTPS with a trusted wildcard certificate. Off by default, on when you need it.

Runtime control

Pin a Node version per project from .nvmrc, engines, or Volta, and run on Node, Bun, or Deno without leaving the app.

Doctor

One command checks DNS, the proxy, port conflicts, the helper daemon, and your resolver file, then tells you exactly how to fix what's wrong.

The CLI

Built for humans and agents alike

At a terminal you get colour and alignment. Piped to a script or an AI, you get clean JSON and proper exit codes - no parsing ANSI escape sequences.

human · TTY
rig list
 
acme-storefront Next running :3001
dashboard-api Nest running :3002
marketing-site Astro stopped :3003
agent · piped
rig list | jq '.[] | select(.status=="Running")'
 
{ "name": "acme-storefront", "framework": "Next", "status": "Running", "port": 3001 }
{ "name": "dashboard-api", "framework": "Nest", "status": "Running", "port": 3002 }

Inspect

rig listList all projects with status
rig statusSystem status: DNS, proxy, counts
rig inspect <name>Full detail: port, pid, memory, uptime, framework
rig metrics <name>Recent memory / CPU samples

Control

rig start <name>Start a project
rig stop <name>Stop a project
rig restart <name>Restart a project
rig run <name> <script>Run a package.json script or Deno task, streaming
rig dev [path]Discover and start a directory without permanently watching it
rig open <name>Open the project URL in your browser

Logs

rig logs <name>Last 100 log lines (use -n to change the count)
rig logs <name> --followStream logs in real time as JSON
rig logs <name> --since 5mLogs from the last duration
rig logs <name> --grep <text>Filter log lines by substring
rig clear-logs <name>Clear a project's log buffer

Config

rig add <path>Watch a folder and discover the projects inside it
rig remove <path>Stop watching a folder
rig ssl <name> <on|off>Toggle per-project HTTPS
rig node <name> [version]Pin a Node version (auto to clear)
rig configPrint all settings
rig config set <key> <value>Set tld, pkg-manager, node-manager, start-on-login
rig exportPrint this machine's shareable config as JSON
rig import <file>Apply a shared config (or - to read stdin)

System

rig free-port <port>Force-free a TCP port
rig doctorRun health checks across DNS, proxy, ports, permissions
rig installSymlink the rig binary onto your PATH
Compatibility

Detects what you already build with

Rig reads your manifest to identify the framework, runtime, and package manager - then resolves the correct dev command for each.

Frameworks

Next.jsNext.js
NestJSNestJS
ViteVite
NuxtNuxt
AstroAstro
RemixRemix
React (CRA)React (CRA)
SvelteKitSvelteKit
SolidStartSolidStart
QwikQwik
HonoHono
FreshFresh

Runtimes

Node.jsNode.js
BunBun
DenoDeno

Package managers

npmnpm
pnpmpnpm
YarnYarn
BunBun
AI skill

Teach your agent to drive Rig

Install the Rig skill into Claude Code, Cursor, or any agent with one command. It learns the full CLI - so it can list projects, tail logs, restart servers, and diagnose port conflicts while it works.

Read the AI skill guide
install the skill
$ npx skills add infinode/rig
Powered by skills.sh - the skill installs into whichever agent you're running.

Run your stack the easy way.

Download Rig for macOS and add your first folder in under a minute.