A terminal multiplexer TUI for running multiple commands side by side in tabs. Built with Bun and Ink.

Draws inspiration from Solo for Laravel, but framework-agnostic — works with any project.

# Global
bun add -g octoplex

# Or run directly
bunx octoplex

Create a .octoplex.json in your project root:

{
  "commands": {
    "Dev Server": "bun run dev",
    "Tailwind": "bunx tailwindcss -w",
    "Tests": {
      "cmd": "bun test --watch",
      "autostart": false
    }
  }
}

Then run:

octoplex

Or generate a config from your package.json scripts:

octoplex init

{
  "commands": {
    "Name": "command string",
    "Name2": {
      "cmd": "command string",
      "autostart": false,
      "cwd": "./subdir",
      "env": { "PORT": "3000" },
      "type": "log"
    }
  }
}

For dynamic configuration:

import { defineConfig } from "octoplex";

export default defineConfig({
  commands: {
    "Dev Server": {
      cmd: "bun run dev",
      autostart: true,
      env: { PORT: process.env.PORT || "3000" },
    },
  },
});

Log mode extras: w toggle wrap, t truncate log

Tabs are also clickable with the mouse.

• Tabbed UI — run multiple commands, switch between them
• Autostart / Lazy — commands start on launch or on demand
• Scrollable output — scroll through command output, freeze the view
• Interactive mode — send keyboard input to a process (shells, REPLs)
• Log tailing — colorizes log levels (ERROR, WARN, INFO, DEBUG)
• Mouse support — click tabs to switch
• Fullscreen — uses alternate screen buffer, restores terminal on exit
• PTY support — full terminal emulation via Bun.Terminal (colors, progress bars, etc.)
• Zero native deps — no node-pty, no compilation step

• Bun >= 1.3.5
• macOS or Linux (uses PTY, no Windows support)

MIT

Tim Broddin — titansofindustry.be