One command
for your entire
dev stack.

Zero-config project detection. Daemon-backed process control. Cross-service log search, port cleanup, health checks, and a terminal UI built for humans and coding agents — no YAML, no Procfile, no Compose for dev.

all releases →

v0.x · MIT · production targets: macOS & Linux on arm64 / amd64

~/your-project · stackplay

§ 02

quick start

Start without writing YAML.

Three commands gets you from clean checkout to a running stack with structured output a coding agent can consume.

01

Install

One script, signed binaries, no package manager required.
02

Run

Auto-detects 86 frameworks across 14 ecosystems. Pick processes interactively.
03

Automate

Headless mode returns JSON when every service is ready. Drop into CI or an agent loop.

§ 03

command reference

The CLI, abridged.

Inspection commands and mutation results are JSON-first, with bounded reads for agent loops. The full reference lives in docs/cli.md.

`stackplay`	Start the daemon and open the TUI.
`stackplay up --json`	Start headlessly and return process state as JSON.
`stackplay ps --json`	Status, PID, CPU, memory, ports, uptime, and last failure.
`stackplay health --json`	An ok / issues verdict for the whole stack.
`stackplay logs api --no-follow --json`	Bounded log read that won’t hang an agent loop.
`stackplay search "error" --json --max-hits 50`	Search every managed process at once.
`stackplay trace "payment" --json`	Merge-sorted timeline across processes.
`stackplay ports :3000 --json`	Inspect listening ports — daemon optional.
`stackplay watch --level error --ndjson`	Typed lifecycle and log events for agents.
`stackplay restart api --dry-run --json`	Preview a restart without applying it.

§ 04

configuration

Explicit when you need it.

stackplay auto-detects common frameworks and monorepos. A checked-in stackplay.yaml gives a team a stable, shared process contract when defaults aren’t enough.

stackplay.yaml 22 lines · YAML

procs:
  api:
    shell: "npm run dev"
    cwd: "./services/api"
    env:
      PORT: "4000"
    autorestart: true
    ports: [4000]

  web:
    shell: "npm run dev"
    cwd: "./apps/web"
    deps: [api]
    ports: [3000]

settings:
  scrollback: 20000
  theme: midnight

§ 05

made for agents

Built for humans and coding agents.

JSON-first for reads and mutations, bounded by default, push-based when you need it. No more silence is not success failures from agents tailing dev servers.

For AI agents

Start a stack, wait for readiness, inspect errors, stream lifecycle events, and restart a process — without scraping terminal tabs or guessing if a build silently crashed.

What it replaces

Stop juggling five dev servers across five terminal tabs, manually tailing logs, guessing which stale process owns port 3000, or letting an agent wait forever on silent output.

headless daemon
terminal UI
cross-process search
port cleanup
health verdicts
agent-safe NDJSON watch

§ 06

finis

Open the daemon. Close the tabs.

star on github →

One command for your entire dev stack.

Install

Run

Automate

One command
for your entire
dev stack.