Basic Commands

Miso comes with a handful of built-in commands to ensure that your experience moving between package managers is perfect.

When you execute commands via miso, it first checks to see if the argument provided is a “built-in” command, if it is, it immediately executes.

To learn more about this, check out Resolution Order

Workspace Scripts (Monorepo)

If your project is configured as a monorepo ("repo": "mono" in miso.json), you can run scripts scoped to a specific workspace using the workspace:script syntax:

miso onboarding:build
miso web:test
miso api:deploy

This runs the script from that workspace’s scripts/ folder and automatically sets the working directory to the workspace root — so all relative paths inside the script resolve correctly.

You can also run workspace scripts without the colon syntax by navigating into the workspace directory first. Miso will automatically scope to that workspace:

cd apps/onboarding
miso build   # resolves against apps/onboarding/scripts/build.sh

See Monorepo Setup for configuration details.

Install Dependencies

Install all dependencies from your lockfile:

miso install
 
# or
 
miso i

Add Packages

Add one or more packages to your project:

miso add @tailwindcss

Flags are passed through to your package manager, exactly as you would expect:

miso add -D vitest    # dev dependency
miso add -E lodash    # exact version

Remove Packages

Remove one or more packages:

miso remove lodash

or

miso rm lodash react redux

Dev

Shortcut for running the dev script:

miso dev

This is equivalent to npm run dev/bun dev but also supports flag configuration.

Scripts

List all available scripts miso can run from both the configured scripts folder and package.json:

miso scripts

Output:

available scripts

scripts folder:
  build (build/index.sh)
  publish/patch (publish/patch.sh)

package.json:
  dev: vite dev
  lint: eslint .

misox

misox is a stand-in replacement for npx.

misox prettier --write .
misox eslint --init

It automatically uses the right tool for your package manager:

Env

Validate environment variables from your .env file:

miso env

See Env Validation for configuration and types.

Version

Show miso version:

miso version
# or
miso v

Output:

miso 1.2.3

Upgrade

Upgrade miso to the latest version:

miso upgrade

To upgrade miso as a local dependency instead of globally, add the --install flag:

miso upgrade --local