Trane ·

Trane is a modern CLI for running parallel tasks with a user-friendly TUI. Think Concurrently, but with a better interface, alias support, runtime validation, and developer-first ergonomics. Create trane.json file in the root directory. Define commands and the working directories. Then simply run trane.

Install

npm install --global @xenoverseup/trane

Usage

trane --help

CLI Options

Usage
  $ trane [options] [alias]

Options
  --file, -f     Path to command config (default: ./trane.json)
  --list         List all available aliases
  --version, -v  Show CLI version
  --help, -h     Show CLI help

Examples
  $ trane                # Launch interactive TUI from trane.json
  $ trane --file=custom.json
  $ trane --list         # Show all available aliases
  $ trane build          # Run alias "build" defined in config

Config File (trane.json)

Define tasks in a config file:

{
  "tasks": {
    "server": {
      "label": "Server",
      "command": "bun",
      "args": ["run", "dev"]
    },
    "dashboard": {
      "label": "Dashboard",
      "command": "bun",
      "args": ["dev"],
      "cwd": "./www/dashboard"
    },
    "landing": {
      "label": "Landing",
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "./www/landing"
    }
  }
}

Types for trane.json

If your editor supports it, enable auto-completion and type-checking:

// @ts-check
// @type {import('@xenoverseup/trane/config').default}
{
  "tasks": {...}
}

TODO Roadmap

• Go migration
• Export logs to file
• Timestamp each output
• Native buffer support
• Clear/reset output buffer
• Dual modes: interactive / headless
• Autocomplete alias names

Muhammed Can Durmus · 2025

Licensed under the MIT License.