◆ Conflux

Note: This project was entirely written by Claude Opus 4.5. It's a prototype. A future version may be rewritten in Zig or Rust for better performance.

A beautiful TUI for running parallel processes with live output streaming. Like turborepo's UI, but standalone.

Features

• 🎨 Beautiful terminal UI with colored process panels
• 📊 Real-time log streaming from multiple processes
• 🖱️ Mouse scroll support for log navigation
• ⌨️ Keyboard shortcuts for quick navigation
• 🔄 Restart individual processes on the fly
• 📝 TypeScript config with full type safety
• ⚡ Built for Bun

Installation

bun add -d conflux-run

Quick Start

Create a conflux.config.ts in your project root:

import type { ConfigFile } from "conflux-run/config";

export default {
  name: "My Project",
  processes: [
    {
      name: "server",
      command: "bun run dev",
      color: "blue",
    },
    {
      name: "worker",
      command: "bun run worker",
      color: "green",
    },
    {
      name: "watch",
      command: "bun run watch",
      color: "magenta",
    },
  ],
} satisfies ConfigFile;

Then run:

bunx conflux-run

Or add to your package.json:

{
  "scripts": {
    "dev": "conflux-run"
  }
}

Controls

| Key | Action | |-----|--------| | 1-9 | Select process by number | | ↑/↓ | Navigate process list | | Mouse scroll | Scroll logs | | PageUp/PageDown | Scroll logs (keyboard) | | r | Restart focused process | | f | Follow mode (auto-scroll) | | q / Ctrl+C | Quit |

Configuration

Config File

Conflux looks for config files in this order:

1. conflux.config.ts
2. conflux.config.json
3. conflux.json

Or specify a custom path:

conflux-runner ./my-config.ts

Options

interface ConfigFile {
  /** Display name shown in the TUI header (defaults to "CONFLUX") */
  name?: string;
  
  /** List of processes to run */
  processes: Array<{
    /** Display name for the process */
    name: string;
    
    /** Command to execute */
    command: string;
    
    /** Panel color: black, red, green, yellow, blue, magenta, cyan, white, gray */
    color?: Color;
    
    /** Working directory (defaults to project root) */
    cwd?: string;
    
    /** Additional environment variables */
    env?: Record<string, string>;
  }>;
}

Programmatic Usage

import { run } from "conflux-run";

// Auto-detect config
await run();

// Or specify config path
await run("./my-config.ts");

Requirements

• Bun >= 1.0.0

License

MIT