Simple Mode

Miso can run without a JavaScript package manager. If you like miso’s script execution, TUI, env validation, and task orchestration but your project isn’t JavaScript — simple mode is for you.

Setup

Run miso init from any directory. If no JavaScript project is detected, miso will offer two options:


? miso could not detect an existing javascript project.
  ❯ Create new project
    Run in simple mode (scripts only, no package manager)

Select “Run in simple mode” and miso will create a miso.json with package management disabled, plus a scripts/ directory:

>miso.json

{
"$schema": "https://misojs.dev/miso.schema.json",
"packageManager": false,
"scripts": "./scripts"
}

How It Works

In simple mode, there are no built-in commands. Every argument you pass to miso is resolved as a script name from the scripts/ folder:


miso build              # runs scripts/build.sh
miso test               # runs scripts/test.sh
miso deploy/convex      # runs scripts/deploy/convex.sh