monoverse

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