monoverse 0.0.15 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +141 -0
  2. package/dist/cli.js +851 -283
  3. package/package.json +15 -13
package/README.md ADDED
@@ -0,0 +1,141 @@
1
+ # Monoverse
2
+
3
+ A zero-config, opinionated monorepo management tool.
4
+
5
+ ## Getting Started
6
+
7
+ Monoverse works out of the box with any monorepo. No configuration needed.
8
+
9
+ ```bash
10
+ # Install
11
+ npm install -g monoverse
12
+
13
+ # Run from anywhere in your monorepo
14
+ monoverse ls
15
+ ```
16
+
17
+ Monoverse auto-detects your package manager (pnpm, yarn, npm, bun) and discovers all workspaces automatically.
18
+
19
+ ## Commands
20
+
21
+ | Command | Description |
22
+ |---------|-------------|
23
+ | **Explore** | |
24
+ | `ls` | List all workspaces in a tree structure |
25
+ | **Dependency Management** | |
26
+ | `add <pkg>` | Add a dependency to the current workspace |
27
+ | `rm <pkg>` | Remove a dependency from the current workspace |
28
+ | **Lint & Fix** | |
29
+ | `lint` | Check for issues across all workspaces |
30
+ | `fix` | Auto-fix detected issues |
31
+ | `format` | Format all package.json files |
32
+ | **TUI** | |
33
+ | `tui` | Terminal UI (coming soon) |
34
+
35
+ ---
36
+
37
+ ### ls
38
+
39
+ List all workspaces in a tree structure.
40
+
41
+ ```bash
42
+ monoverse ls
43
+ ```
44
+
45
+ ```
46
+ Workspaces (12)
47
+
48
+ my-monorepo
49
+ ├── apps
50
+ │ ├── web (web)
51
+ │ └── mobile (mobile)
52
+ └── packages
53
+ ├── ui (@acme/ui)
54
+ └── utils (@acme/utils) (cwd)
55
+ ```
56
+
57
+ ---
58
+
59
+ ### add
60
+
61
+ Add a dependency to the current workspace.
62
+
63
+ ```bash
64
+ monoverse add lodash
65
+ monoverse add -t dev vitest
66
+ monoverse add -v 5.0.0 lodash
67
+ ```
68
+
69
+ | Option | Description |
70
+ |--------|-------------|
71
+ | `-t, --type` | `dependency` (default), `dev`, `peer`, `optional` |
72
+ | `-v, --version` | Specific version to install |
73
+
74
+ Syncs to existing versions in other workspaces when available.
75
+
76
+ ---
77
+
78
+ ### rm
79
+
80
+ Remove a dependency from the current workspace.
81
+
82
+ ```bash
83
+ monoverse rm lodash
84
+ ```
85
+
86
+ ---
87
+
88
+ ### lint
89
+
90
+ Check for issues across all workspaces.
91
+
92
+ ```bash
93
+ monoverse lint
94
+ ```
95
+
96
+ Detects:
97
+ - Version mismatches across workspaces
98
+ - Unpinned versions (`^1.0.0`, `~1.0.0`)
99
+ - Unformatted package.json files
100
+ - Duplicate workspace names
101
+
102
+ ---
103
+
104
+ ### fix
105
+
106
+ Auto-fix detected issues.
107
+
108
+ ```bash
109
+ monoverse fix
110
+ monoverse fix -i
111
+ ```
112
+
113
+ | Option | Description |
114
+ |--------|-------------|
115
+ | `-i, --interactive` | Resolve version mismatches interactively |
116
+
117
+ ---
118
+
119
+ ### format
120
+
121
+ Format all package.json files.
122
+
123
+ ```bash
124
+ monoverse format
125
+ ```
126
+
127
+ ## Advanced Configuration
128
+
129
+ For managing multiple monorepos together, create a `monoverse.json`:
130
+
131
+ ```json
132
+ {
133
+ "projects": [".", "../other-monorepo", "./packages/*"]
134
+ }
135
+ ```
136
+
137
+ Accepts direct paths and glob patterns.
138
+
139
+ ## License
140
+
141
+ MIT