Helix

A terminal UI for monitoring processes. Run everything at once, watch logs per process, restart on the fly.

Installation

bun add -g @stellix-agency/helix

Quick Start

cd your-repo
helix init     # Interactive Setup → Generates helix.config.ts
helix          # Launch

Config

// helix.config.ts
import { defineConfig } from "@stellix-agency/helix";

export default defineConfig({
  name: "My Project",
  runner: "pnpm",   // Supports: vp (Vite+) | pnpm | npm | yarn | bun
  cwd: ".",
  processes: [
    { name: "App",  filter: "@scope/app",  script: "dev" },
    { name: "API",  filter: "@scope/api",  script: "dev" },
    { name: "Docs", filter: "@scope/docs", script: "dev" },
  ],
});

cwd is resolved relative to the config file location.
Each process runs as runner run --filter filter script.

Keybindings

| Key | Action | |-----|--------| | ↑ / ↓ | Switch between processes | | Shift + ↑ / Shift + ↓ | Scroll logs | | r | Restart selected process | | c | Clear logs for selected process | | / | Search logs (type to filter, Enter confirm, Esc cancel) | | q / Ctrl+C | Quit |

Log lines containing error or fail are highlighted red, warn in yellow, no any config is needed. Detected localhost:PORT URLs are shown in the process list as soon as they appear in the logs.