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, the package-management commands and package.json fallback are gone. Miso’s utility commands still work — help, init, version, upgrade, completion, skills, env, and scripts — and every other argument resolves 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