Basic Commands

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

In simple mode ("packageManager": false), there are no built-in commands — everything resolves as a script. The commands below (install, add, remove, dev, misox) are only available when a package manager is configured.

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


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 .

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 --local flag:


miso upgrade --local

misox

misox is a stand-in replacement for npx.


misox prettier --write .
misox eslint --init