devpanes, by Voudo

Split-pane terminal UI for managing multiple dev processes. Zero dependencies, pure ESM, Node >= 18.

Install

# Install as a dev dependency (recommended)
npm install --save-dev @voudo/devpanes

Note: npx @voudo/devpanes won't work due to an npm quirk with scoped packages where the bin name (devpanes) doesn't match the package name. Use the one-liner below, or just install it first and run npx devpanes.

# Zero-install one-liner
npx -p @voudo/devpanes devpanes

Quick Start

Create devpanes.config.mjs in your project root:

export default {
  name: 'My Project',
  apps: [
    { key: 'web', label: 'Frontend', cwd: 'packages/web', cmd: 'npm', args: ['run', 'dev'], port: 3000 },
    { key: 'api', label: 'API', cwd: 'packages/api', cmd: 'npm', args: ['start'], port: 8080 },
    { key: 'db', label: 'Database', cwd: '.', cmd: 'docker', args: ['compose', 'up'], shell: true },
  ],
}

Then add a script to package.json and run:

{ "scripts": { "dev": "devpanes" } }

npm run dev

CLI Options

devpanes [options]
  --config <path>    Path to config file
  --all              Start all apps, skip selection menu
  --apps <keys>      Comma-separated app keys to start (e.g. --apps web,api)
  --help             Show help
  --version          Show version

Config Reference

Config file discovery

1. --config <path> CLI flag
2. devpanes.config.mjs in current directory
3. devpanes.config.js in current directory
4. "devpanes" key in package.json

Config shape

export default {
  name: 'Project Name',      // optional — shown in menu header
  apps: [                     // required — at least one app
    {
      key: 'web',             // required — unique identifier
      label: 'Web App',       // required — display name
      cwd: 'packages/web',   // required — working directory (relative to config file)
      cmd: 'npm',             // required — command to run
      args: ['run', 'dev'],   // optional — arguments (default: [])
      port: 3000,             // optional — enables port-in-use detection
      env: { NODE_ENV: 'dev' }, // optional — extra environment variables
      shell: false,           // optional — pass to child_process.spawn
      infra: {                // optional — pre-start command
        cmd: 'docker',
        args: ['compose', 'up', '-d'],
        label: 'docker',
      },
    },
  ],
  settings: {                 // optional
    maxBufferLines: 500,      // lines per pane buffer (default: 500)
    colors: [...],            // custom ANSI color rotation
    pathAugment: true,        // add node_modules/.bin to PATH (default: true)
  },
}

Keyboard Shortcuts

Key	Action
1-9	Toggle pane visibility
! @ # $ % ^ &	Expand/collapse pane (Shift+1-7)
s	Start more apps (opens selection menu)
k	Kill an app (opens kill menu)
q / Ctrl+C	Quit — stops all apps and restores terminal

Features

• Interactive selection menu — choose which apps to start with checkbox UI
• Split-pane output — each process gets its own vertical pane with color-coded output
• Expand/collapse — focus on one pane while keeping others visible
• Show/hide — toggle panes on and off with number keys
• Port detection — warns when a port is already in use
• Infrastructure pre-start — run setup commands (e.g. docker compose) before starting an app
• Graceful cleanup — kills all process groups and restores terminal on exit
• 60fps debounced rendering — smooth output even with fast-scrolling builds
• 500-line circular buffers — keeps memory bounded per pane

License

MIT