Monoverse

A zero-config, opinionated monorepo management tool.

Prerequisites

Bun is required to run monoverse.

# Install Bun (macOS, Linux, WSL)
curl -fsSL https://bun.sh/install | bash

Getting Started

Monoverse works out of the box with any monorepo. No configuration needed.

# Install
npm install -g monoverse

# Run from anywhere in your monorepo
monoverse ls

Monoverse auto-detects your package manager (pnpm, yarn, npm, bun) and discovers all workspaces automatically.

Commands

| Command | Description | |---------|-------------| | Explore | | | ls | List all workspaces in a tree structure | | Dependency Management | | | add <pkg> | Add a dependency to the current workspace | | rm <pkg> | Remove a dependency from the current workspace | | Lint & Fix | | | lint | Check for issues across all workspaces | | fix | Auto-fix detected issues | | format | Format all package.json files | | TUI | | | tui | Terminal UI (coming soon) |

ls

List all workspaces in a tree structure.

monoverse ls

Workspaces (12)

my-monorepo
├── apps
│   ├── web (web)
│   └── mobile (mobile)
└── packages
    ├── ui (@acme/ui)
    └── utils (@acme/utils) (cwd)

add

Add a dependency to the current workspace.

monoverse add lodash
monoverse add -t dev vitest
monoverse add -v 5.0.0 lodash

| Option | Description | |--------|-------------| | -t, --type | dependency (default), dev, peer, optional | | -v, --version | Specific version to install |

Syncs to existing versions in other workspaces when available.

rm

Remove a dependency from the current workspace.

monoverse rm lodash

lint

Check for issues across all workspaces.

monoverse lint

Detects:

• Version mismatches across workspaces
• Unpinned versions (^1.0.0, ~1.0.0)
• Unformatted package.json files
• Duplicate workspace names

fix

Auto-fix detected issues.

monoverse fix
monoverse fix -i

| Option | Description | |--------|-------------| | -i, --interactive | Resolve version mismatches interactively |

format

Format all package.json files.

monoverse format

Advanced Configuration

For managing multiple monorepos together, create a monoverse.json:

{
  "projects": [".", "../other-monorepo", "./packages/*"]
}

Accepts direct paths and glob patterns.

License

MIT