Configuration

`tui`

Controls how concurrent scripts are displayed.

>miso.json

"tui": "off" | "tabbed" | "merged"

"off"

Default

No TUI. Normal single-process execution.

"tabbed"

Sidebar with workspace list, selected workspace’s logs on the right. See Tabbed Mode.

"merged"

Interleaved log stream with colored labels and filter toggles. See Merged Mode.

You can also use the object form for additional options:

>miso.json

{
"tui": {
  "mode": "tabbed",
  "cleanExit": true
}
}

mode

TUI display mode. Accepts "off", "tabbed", or "merged".

cleanExit

When true, suppresses the log dump on TUI exit. By default, all buffered output is printed to stdout when the TUI exits.

`repo`

Controls how miso discovers and orchestrates workspaces.

>miso.json

"repo": "single" | "mono" | "turbo" | "nx"

"single"

Default

Standard project. Uses concurrent in task config for companion scripts.

"mono"

Monorepo. Miso discovers workspaces and orchestrates scripts directly.

"turbo"

Monorepo. Delegates orchestration to Turborepo, miso provides the TUI. turbo must be available in your PATH.

"nx"

Monorepo. Delegates orchestration to Nx, miso provides the TUI. nx must be available in your PATH.

You can also use the object form to configure per-task behaviour:

>miso.json

{
"repo": {
  "mode": "mono",
  "tasks": {
    "build": {
      "dependsOn": ["^build"]
    },
    "dev": {
      "concurrent": ["db:convex", "docker:run"]
    }
  }
}
}

dependsOn

Array of task names to run before this one. The ^ prefix (e.g. "^build") means run the task in upstream workspace dependencies first, reading the dependency graph from each workspace’s package.json.

concurrent

Array of additional task names to discover and run in parallel alongside the main task. In turbo/nx mode, tasks listed here use miso’s direct orchestration instead of delegation.

Commands not listed in tasks, or listed without dependsOn, run all workspaces in parallel.