Skip to content

prox

A modern process manager for development with an API-first design, enabling both human interaction and LLM tooling integration.

Features

  • Simple by default - Procfile-like experience with minimal YAML configuration
  • API-first - Full process control and log access via HTTP, always available
  • Interactive TUI - Real-time log viewing with filtering and search
  • HTTP/HTTPS Proxy - Friendly local hostnames with optional locally-trusted certificates
  • Shared proxy daemon - Multiple projects can use the same local HTTP or HTTPS port
  • Health checks - Optional health monitoring for processes
  • LLM-friendly - Structured output and filtering to support AI-assisted debugging

Quick Example

Create a prox.yaml:

processes:
  web: npm run dev
  api: go run ./cmd/server
  worker: python worker.py

Start all processes:

prox up

Current Scope

prox is designed for local development. It supports external-resource dependencies (dependencies:, with readiness checks and an optional start command), one-shot setup tasks (tasks:), and gating a process's launch on either (depends_on) — see the Dependencies, Tasks, and Process Gating guide. It intentionally does not include:

  • Log persistence to disk
  • Process-to-process ordering (one process launching only after another process, as opposed to a dependency or task) or cross-project startup ordering
  • Distributed or multi-machine operation

See the Roadmap for planned features.

Next Steps