dev-prune 1.4.0__py3-none-win32.whl
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.
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,706 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: dev-prune
|
|
3
|
+
Version: 1.4.0
|
|
4
|
+
Summary: Universal, lockfile-safe workspace pruner. Reclaims disk space from idle Git repositories by deleting only dependency and build directories a lockfile can rebuild.
|
|
5
|
+
Author: VKrishna04
|
|
6
|
+
License: Apache-2.0
|
|
7
|
+
Keywords: cli,cleanup,disk-space,node_modules,venv,monorepo,workspace,prune
|
|
8
|
+
Project-URL: Homepage, https://devprune.vkrishna04.me
|
|
9
|
+
Project-URL: Documentation, https://github.com/Life-Experimentalist/dev-prune/blob/main/docs/README.md
|
|
10
|
+
Project-URL: Source, https://github.com/Life-Experimentalist/dev-prune
|
|
11
|
+
Project-URL: Issues, https://github.com/Life-Experimentalist/dev-prune/issues
|
|
12
|
+
Project-URL: Changelog, https://github.com/Life-Experimentalist/dev-prune/blob/main/CHANGELOG.md
|
|
13
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
14
|
+
Classifier: Environment :: Console
|
|
15
|
+
Classifier: Intended Audience :: Developers
|
|
16
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
17
|
+
Classifier: Operating System :: MacOS
|
|
18
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
19
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
20
|
+
Classifier: Programming Language :: Rust
|
|
21
|
+
Classifier: Topic :: Software Development :: Build Tools
|
|
22
|
+
Classifier: Topic :: System :: Filesystems
|
|
23
|
+
Classifier: Topic :: Utilities
|
|
24
|
+
Requires-Python: >=3.8
|
|
25
|
+
Description-Content-Type: text/markdown
|
|
26
|
+
|
|
27
|
+
```text
|
|
28
|
+
___ _____ __ __ ____ ____ _ _ _ _ _____
|
|
29
|
+
| _ \ | ____|\ \ / / | _ \| _ \| | | | \ | | ____|
|
|
30
|
+
| | | || _| \ \ / / | |_) | |_) | | | | \| | _|
|
|
31
|
+
| |_| || |___ \ V / | __/| _ <| |_| | |\ | |___
|
|
32
|
+
|____/ |_____| \_/ |_| |_| \_\\___/|_| \_|_____|
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
<div align="center">
|
|
36
|
+
|
|
37
|
+
# `dev-prune` · `devp` — by [VKrishna04](https://github.com/VKrishna04)
|
|
38
|
+
|
|
39
|
+
>**Reclaim the disk space your idle repositories are sitting on — without ever deleting**
|
|
40
|
+
**something a lockfile cannot put back.**
|
|
41
|
+
|
|
42
|
+
[](https://crates.io/crates/dev-prune) [](https://pypi.org/project/dev-prune/) [](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/LICENSE.md) [](https://www.rust-lang.org/) [](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/RELEASES_AND_MANUAL_INSTALL.md)
|
|
43
|
+
|
|
44
|
+
[](https://github.com/Life-Experimentalist/dev-prune/actions/workflows/ci.yml) [](https://devprune.vkrishna04.me/)
|
|
45
|
+
|
|
46
|
+
<!-- The npm badge goes back in the row above the moment `dev-prune` is published to
|
|
47
|
+
npm; until then shields.io renders it as a red "not found", which is worse than
|
|
48
|
+
having no badge at all:
|
|
49
|
+
[](https://www.npmjs.com/package/dev-prune) -->
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
[**Website**](https://devprune.vkrishna04.me/) · [**Documentation**](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/README.md) · [**CLI reference**](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/CLI_REFERENCE.md) · [**Safety invariants**](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/SAFETY_INVARIANTS.md) · [**Changelog**](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/CHANGELOG.md)
|
|
53
|
+
|
|
54
|
+
<img src="https://raw.githubusercontent.com/Life-Experimentalist/dev-prune/v1.4.0/assets/readme-banner.png" alt="dev-prune — get the gigabytes back, lose nothing" width="820" />
|
|
55
|
+
|
|
56
|
+
</div>
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
`node_modules`, `.venv`, `target` and `vendor` are the largest directories on most
|
|
61
|
+
developers' machines, and the least valuable: every byte in them is described by a
|
|
62
|
+
lockfile that is already committed. A project you have not opened since March is holding
|
|
63
|
+
gigabytes hostage for a build you are not running.
|
|
64
|
+
|
|
65
|
+
`dev-prune` finds those directories across every Git repository you register, and deletes
|
|
66
|
+
them — but only after proving the exact command that puts them back would succeed. It is
|
|
67
|
+
a single Rust binary, installs its own background schedule, and answers to two names:
|
|
68
|
+
`dev-prune` and `devp`.
|
|
69
|
+
|
|
70
|
+
> [!IMPORTANT]
|
|
71
|
+
> **The rule the whole tool is built around:** nothing is deleted unless dev-prune has
|
|
72
|
+
> just verified, read-only, that its lockfile can rebuild it. There is no flag to skip
|
|
73
|
+
> that check. `--ignore-idle` lifts the idle-day wait and *nothing else*.
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Contents
|
|
78
|
+
<div align="center">
|
|
79
|
+
|
|
80
|
+
[Install](#install) · [60-second tour](#60-second-tour) · [What it looks like](#what-it-looks-like) · [Why it is safe](#why-it-is-safe) · [Features](#features) · [Commands](#commands) · [Ecosystems](#supported-ecosystems) · [Monorepos](#repositories-with-more-than-one-ecosystem) · [Configuration](#configuration) · [Automation](#background-automation) · [Comparison](#how-it-compares) · [Architecture](#architecture) · [Docs](#documentation)
|
|
81
|
+
|
|
82
|
+
</div>
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Install
|
|
87
|
+
|
|
88
|
+
### One-liner
|
|
89
|
+
|
|
90
|
+
Pick the line for the shell you are actually typing into. Pasting the first one into a
|
|
91
|
+
Command Prompt is the most common install failure there is — it answers
|
|
92
|
+
`'sh' is not recognized as an internal or external command`, because `sh` is a Unix shell
|
|
93
|
+
and Windows does not ship one.
|
|
94
|
+
|
|
95
|
+
**Linux, macOS, or a Unix shell on Windows** — Git Bash, MSYS2, Cygwin, WSL:
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
curl -fsSL https://devprune.vkrishna04.me/install.sh | sh
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
**Windows PowerShell** — the blue or black `PS>` prompt, and Windows Terminal's default:
|
|
102
|
+
|
|
103
|
+
```powershell
|
|
104
|
+
iwr -useb https://devprune.vkrishna04.me/install.ps1 | iex
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
**Windows Command Prompt** — the `C:\>` prompt, which has no `iwr` of its own:
|
|
108
|
+
|
|
109
|
+
```bat
|
|
110
|
+
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://devprune.vkrishna04.me/install.ps1 | iex"
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
All three download the prebuilt binary for your platform, verify its published SHA-256,
|
|
114
|
+
put it on `PATH`, and run `dev-prune setup`. Pass `--no-auto-setup` / `-NoAutoSetup` to
|
|
115
|
+
skip that last step.
|
|
116
|
+
|
|
117
|
+
The Command Prompt form installs identically to the PowerShell one, but `cmd` cannot
|
|
118
|
+
inherit the `PATH` the installer sets in its own process, so `devp` resolves in the *next*
|
|
119
|
+
Command Prompt you open rather than the current one. PowerShell does not have that
|
|
120
|
+
problem.
|
|
121
|
+
|
|
122
|
+
### From a package manager
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
uv tool install dev-prune # or: uvx dev-prune status
|
|
126
|
+
pipx install dev-prune
|
|
127
|
+
pip install dev-prune
|
|
128
|
+
cargo binstall dev-prune # fetches the prebuilt release archive
|
|
129
|
+
cargo install dev-prune # builds from source, needs Rust 1.88+
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
The PyPI packages **contain the binary** — there is no download step at install time,
|
|
133
|
+
so they work behind a registry mirror and offline. Everything but `cargo install` ships
|
|
134
|
+
a prebuilt executable.
|
|
135
|
+
|
|
136
|
+
crates.io stores source and nothing else, so `cargo install` has no binary to fetch and
|
|
137
|
+
always compiles. [`cargo binstall`](https://github.com/cargo-bins/cargo-binstall) is the
|
|
138
|
+
one that downloads: `Cargo.toml` tells it where this project's release archives live, so
|
|
139
|
+
it unpacks the same executable the installers use, with no toolchain involved.
|
|
140
|
+
|
|
141
|
+
The two Python entry points differ in where they land. `pip install` follows whichever
|
|
142
|
+
environment is active, so inside a virtualenv `devp` lives in that venv's `Scripts`/`bin`
|
|
143
|
+
and disappears with it; `pip install --user`, `pipx` and `uv tool install` are the
|
|
144
|
+
machine-wide forms. [Where each one puts the executables](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/troubleshooting/INSTALLATION_ISSUES.md#6-uv-tool-install-put-the-executables-somewhere-unexpected).
|
|
145
|
+
|
|
146
|
+
### Direct download
|
|
147
|
+
|
|
148
|
+
Seven checksummed archives per release on
|
|
149
|
+
[GitHub Releases](https://github.com/Life-Experimentalist/dev-prune/releases) — Windows,
|
|
150
|
+
macOS and Linux on x64 and arm64, plus a 32-bit `windows-x86` build for machines with no
|
|
151
|
+
64-bit mode. The Linux binaries are statically linked against musl, so one file per
|
|
152
|
+
architecture runs on every distribution including Alpine.
|
|
153
|
+
|
|
154
|
+
Manual install and build-from-source:
|
|
155
|
+
[docs/RELEASES_AND_MANUAL_INSTALL.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/RELEASES_AND_MANUAL_INSTALL.md).
|
|
156
|
+
|
|
157
|
+
### Let an AI assistant do it
|
|
158
|
+
|
|
159
|
+
Copy the prompt below and paste it to Claude Code, Cursor, GitHub Copilot, Windsurf, or
|
|
160
|
+
any terminal-capable agent — it installs, verifies, and registers your projects for you.
|
|
161
|
+
[More detail and per-tool notes.](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/AI_SETUP_PROMPT.md)
|
|
162
|
+
|
|
163
|
+
````text
|
|
164
|
+
Install and set up `dev-prune` (binary name `devp`), a lockfile-safe workspace cleaner,
|
|
165
|
+
on this machine. Follow these steps exactly and do not improvise beyond them.
|
|
166
|
+
|
|
167
|
+
1. Detect the OS and run the matching official installer, nothing else:
|
|
168
|
+
- macOS or Linux:
|
|
169
|
+
curl -fsSL https://devprune.vkrishna04.me/install.sh | sh
|
|
170
|
+
- Windows (PowerShell):
|
|
171
|
+
iwr -useb https://devprune.vkrishna04.me/install.ps1 | iex
|
|
172
|
+
- If a Rust toolchain is already present and you cannot reach the network, you may
|
|
173
|
+
instead run: cargo install dev-prune
|
|
174
|
+
Do NOT download binaries from anywhere other than devprune.vkrishna04.me or the
|
|
175
|
+
project's GitHub releases, and do NOT edit PATH, the registry, or any OS scheduler by
|
|
176
|
+
hand — the installer and `devp setup` do all of that themselves.
|
|
177
|
+
|
|
178
|
+
2. Open a NEW terminal (so the updated PATH is in effect) and verify:
|
|
179
|
+
devp --version
|
|
180
|
+
devp doctor
|
|
181
|
+
`devp doctor` must exit 0. If it prints warnings, read them out to me; do not try to
|
|
182
|
+
"fix" the scheduler or hooks yourself — they are self-installing.
|
|
183
|
+
|
|
184
|
+
3. Ask me which project directories to keep clean, then register each one:
|
|
185
|
+
devp init <path>
|
|
186
|
+
Do not register directories I did not name. `devp init` only records a directory; it
|
|
187
|
+
never deletes anything on its own.
|
|
188
|
+
|
|
189
|
+
4. Show me the result and stop:
|
|
190
|
+
devp status
|
|
191
|
+
|
|
192
|
+
Notes you should rely on, not work around:
|
|
193
|
+
- Installation already registered a background pass (every 2 days) and, on Windows, a
|
|
194
|
+
windowless task that never flashes a console window. You do not need to configure any
|
|
195
|
+
of this.
|
|
196
|
+
- Nothing is ever deleted unless a lockfile can rebuild it, the repo has been idle past
|
|
197
|
+
the threshold, and (interactively) I confirm. Run `devp run --dry-run` if I want a
|
|
198
|
+
preview.
|
|
199
|
+
- To undo the whole thing later: `devp uninstall`.
|
|
200
|
+
````
|
|
201
|
+
|
|
202
|
+
Every install channel in detail: [docs/DISTRIBUTION.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/DISTRIBUTION.md).
|
|
203
|
+
|
|
204
|
+
> [!TIP]
|
|
205
|
+
> **`devp` is a real executable, not a shell alias.** Installation puts a second binary
|
|
206
|
+
> next to `dev-prune`, so the short name works in cmd, PowerShell, bash, fish, an IDE
|
|
207
|
+
> terminal and a scheduled task alike — with no profile to re-source, and no chance of an
|
|
208
|
+
> upgrade leaving `devp` on the old version.
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## 60-second tour
|
|
213
|
+
|
|
214
|
+
```bash
|
|
215
|
+
devp init ~/Projects # register every Git repository under a tree
|
|
216
|
+
devp status # dashboard: what is tracked, what is reclaimable
|
|
217
|
+
devp run --dry-run # what a pass would delete — changes nothing
|
|
218
|
+
devp run # do it, after confirming
|
|
219
|
+
devp restore --last-run # put back exactly what that pass deleted
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
A few more worth knowing on day one:
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
devp stats # how much has been reclaimed so far, and by which repositories
|
|
226
|
+
devp caches # every package manager cache, sized. The report deletes nothing
|
|
227
|
+
devp status --drift # anything installed that the lockfiles don't record?
|
|
228
|
+
devp doctor . # why is this repository not being pruned?
|
|
229
|
+
devp doctor --fix # repair a broken integration — never a first-time install
|
|
230
|
+
devp -V # version, OS, architecture, config path, PATH audit
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
---
|
|
234
|
+
|
|
235
|
+
## What it looks like
|
|
236
|
+
|
|
237
|
+
<details open>
|
|
238
|
+
<summary><b><code>devp run --dry-run</code></b> — the plan, before anything is touched</summary>
|
|
239
|
+
|
|
240
|
+
```console
|
|
241
|
+
$ devp run --dry-run
|
|
242
|
+
|
|
243
|
+
dev-prune run (DRY RUN)
|
|
244
|
+
→ Scanning 4 registered repositories for prune candidates...
|
|
245
|
+
|
|
246
|
+
Prune Candidates & Space Savings Calculation
|
|
247
|
+
→ • ~/Code/acme-api → node_modules (412.7 MiB) [pnpm]
|
|
248
|
+
→ • ~/Code/acme-api → services/worker/.venv (188.2 MiB) [uv]
|
|
249
|
+
→ • ~/Code/render-farm → target (2.14 GiB) [cargo]
|
|
250
|
+
→ • ~/Code/edge-proxy → vendor (96.4 MiB) [go]
|
|
251
|
+
|
|
252
|
+
Summary (Dry Run)
|
|
253
|
+
→ Would free 2.82 GiB across 4 bloat directories.
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
</details>
|
|
257
|
+
|
|
258
|
+
<details>
|
|
259
|
+
<summary><b><code>devp status</code></b> — the dashboard, or a plain table with no TTY</summary>
|
|
260
|
+
|
|
261
|
+
```console
|
|
262
|
+
$ devp status
|
|
263
|
+
|
|
264
|
+
→ Global Config Location: ~/.config/dev-prune/registry.json
|
|
265
|
+
→ Background OS Daemon: Installed
|
|
266
|
+
→ Background Git Hooks: Installed
|
|
267
|
+
→ Global Command Timeout: 600s (10m)
|
|
268
|
+
→ Tracked Repositories: 4
|
|
269
|
+
→ Historical Space Saved: 6.31 GiB across 9 prune passes
|
|
270
|
+
|
|
271
|
+
dev-prune status
|
|
272
|
+
|
|
273
|
+
# Repository Status / Reason Adapters Bloat Last Activity Last Pruned
|
|
274
|
+
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
275
|
+
1 acme-api Candidate pnpm+uv 600.9 MiB 2026-04-02 Never
|
|
276
|
+
2 render-farm Candidate cargo 2.14 GiB 2026-03-11 2026-01-08
|
|
277
|
+
3 edge-proxy Candidate go 96.4 MiB 2026-05-19 Never
|
|
278
|
+
4 dashboard Active (not idle) npm 314.0 MiB 2026-08-12 2026-06-30
|
|
279
|
+
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
280
|
+
→ Total: 4 repos | 3 candidates | 3.13 GiB reclaimable
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
Keys: `↑`/`↓` move, `p` pre-selects every candidate, `Space` deselects the one you are
|
|
284
|
+
keeping, `Enter` prunes the rest, `i` toggles ignore for a repository, `q` exits.
|
|
285
|
+
|
|
286
|
+
</details>
|
|
287
|
+
|
|
288
|
+
<details>
|
|
289
|
+
<summary><b><code>devp caches</code></b> — where the rest of the disk went</summary>
|
|
290
|
+
|
|
291
|
+
```console
|
|
292
|
+
$ devp caches
|
|
293
|
+
|
|
294
|
+
Package manager caches
|
|
295
|
+
|
|
296
|
+
uv cache 16.25 GiB ~/.cache/uv
|
|
297
|
+
clear: uv cache prune
|
|
298
|
+
|
|
299
|
+
npm cache 8.97 GiB ~/.npm
|
|
300
|
+
clear: npm cache clean --force
|
|
301
|
+
|
|
302
|
+
go build cache 371.75 MiB ~/.cache/go-build
|
|
303
|
+
clear: go clean -cache
|
|
304
|
+
compiled build artifacts; clearing them means the next build is a cold one
|
|
305
|
+
|
|
306
|
+
cargo registry sources 104.75 MiB ~/.cargo/registry/src
|
|
307
|
+
clear: rm -rf ~/.cargo/registry/src
|
|
308
|
+
unpacked copies of the archives above; cargo re-extracts these offline
|
|
309
|
+
|
|
310
|
+
… (pip, bun, pnpm, go module cache, cargo registry cache)
|
|
311
|
+
|
|
312
|
+
Total 27.26 GiB across 9 caches
|
|
313
|
+
|
|
314
|
+
→ Nothing above was deleted, and dev-prune never deletes any of it.
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
A cache lives outside every repository and is shared by all of them, so no single
|
|
318
|
+
lockfile can prove it recoverable — and it is what makes `devp restore` fast. `devp
|
|
319
|
+
caches` reports and prints the clear command; running it is your decision.
|
|
320
|
+
|
|
321
|
+
</details>
|
|
322
|
+
|
|
323
|
+
<details>
|
|
324
|
+
<summary><b><code>devp doctor .</code></b> — the one reason a repository is being skipped</summary>
|
|
325
|
+
|
|
326
|
+
```console
|
|
327
|
+
$ devp doctor .
|
|
328
|
+
|
|
329
|
+
dev-prune doctor (~/Code/dashboard)
|
|
330
|
+
|
|
331
|
+
Repository
|
|
332
|
+
Git repository ✓ yes
|
|
333
|
+
Registered ✓ yes, since 2026-04-11
|
|
334
|
+
.devprune.json parses; idle_days 20
|
|
335
|
+
Opt-out none
|
|
336
|
+
Activity 2026-08-12 (0 days ago), threshold 20 — active
|
|
337
|
+
Size floor none — every recognised directory counts
|
|
338
|
+
Scan depth 6 levels below the root
|
|
339
|
+
|
|
340
|
+
Projects
|
|
341
|
+
|
|
342
|
+
. (npm)
|
|
343
|
+
Lockfile ✓ package-lock.json present
|
|
344
|
+
Bloat ✓ node_modules (314.0 MiB)
|
|
345
|
+
|
|
346
|
+
Verdict
|
|
347
|
+
✗ Would `devp run` prune this? No — active within the last 20 days.
|
|
348
|
+
`devp --ignore-idle run ~/Code/dashboard` overrides exactly that check and nothing else.
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
It runs no package manager and repairs nothing, so it is safe to run twice — once to see
|
|
352
|
+
the problem, once to confirm the fix. Without a path it audits the installation instead:
|
|
353
|
+
binary location and `PATH`, the registry and every setting in it, the integrations, which
|
|
354
|
+
package managers are reachable, and the release-check state.
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
|
|
358
|
+
</details>
|
|
359
|
+
|
|
360
|
+
---
|
|
361
|
+
|
|
362
|
+
## Why it is safe
|
|
363
|
+
|
|
364
|
+
Seven invariants, enforced in code rather than by convention, none of which has a bypass
|
|
365
|
+
flag. Full detail and the reasoning behind each in
|
|
366
|
+
[docs/SAFETY_INVARIANTS.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/SAFETY_INVARIANTS.md).
|
|
367
|
+
|
|
368
|
+
| # | Invariant | What it prevents |
|
|
369
|
+
| :---: | :-------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------ |
|
|
370
|
+
| 1 | **`.git` boundary** — only ever operates inside a directory holding a `.git` root | Deleting a `node_modules` that belongs to no repository and has no lockfile behind it |
|
|
371
|
+
| 2 | **Lockfile pre-verification** — the ecosystem's own read-only check must pass first | Deleting a tree whose lockfile has drifted, leaving a reinstall that fails |
|
|
372
|
+
| 3 | **Hybrid activity solver** — the later of the last commit and the newest source `mtime` | Pruning a project with a week of uncommitted work in it |
|
|
373
|
+
| 4 | **Atomic state writes** — write to a temp file, then rename | A registry corrupted by a crash or a power cut mid-write |
|
|
374
|
+
| 5 | **0ms ignore fast path** — `ignore.devprune.json` short-circuits before any parsing | A repository you opted out of being scanned at all |
|
|
375
|
+
| 6 | **Symlink and junction refusal** | Following a link out of the repository and deleting storage it does not own |
|
|
376
|
+
| 7 | **Nested repository boundary** | A submodule being deleted as part of its parent instead of on its own terms |
|
|
377
|
+
|
|
378
|
+
Verification is **read-only by default**: `npm ci --dry-run`, `uv lock --locked`, `cargo
|
|
379
|
+
metadata --locked`, `go mod download`. Each resolves the dependency graph against the
|
|
380
|
+
lockfile on disk and *fails* when the two disagree, instead of quietly rewriting the
|
|
381
|
+
lockfile and continuing. The writing form runs in exactly two cases — when no lockfile
|
|
382
|
+
exists at all, and when you have asked with `devp config set allow_manifest_rewrite true`
|
|
383
|
+
— because a pass can be started by the OS scheduler while you are away, and a background
|
|
384
|
+
process that leaves a dirty working tree is a surprise.
|
|
385
|
+
|
|
386
|
+
---
|
|
387
|
+
|
|
388
|
+
## Features
|
|
389
|
+
|
|
390
|
+
| | |
|
|
391
|
+
| :-------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
392
|
+
| 🔒 **Lockfile-gated deletion** | Nothing goes without a passing read-only verification against `package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lock`, `uv.lock`, `requirements.txt`, `Cargo.lock` or `go.sum` |
|
|
393
|
+
| 🧩 **Any number of ecosystems per repository** | uv, npm and cargo in one root, or spread across `frontend/`, `services/api/` and `tools/cli/` — each discovered, verified and pruned on its own terms |
|
|
394
|
+
| ↩️ **One-command restore** | `devp restore .` reinstalls a tree; `devp restore --last-run` puts back exactly what the most recent pass deleted, across every repository it touched |
|
|
395
|
+
| 🕒 **Activity-aware** | Combines `git log` timestamps with source-file `mtime`, so uncommitted work protects a repository just as a commit does |
|
|
396
|
+
| 📊 **Cache report** | `devp caches` sizes every package manager cache and store on the machine — npm to cargo to Maven, Gradle, NuGet, vcpkg and Conan — and prints the command that clears each. The report is read-only; `devp caches clear <manager>` runs that command for you, after asking. Nothing on a schedule ever touches a cache |
|
|
397
|
+
| 🩺 **`devp doctor`** | One read-only pass that ends by naming the *single* reason a repository would or would not be pruned. Runs no package manager, repairs nothing, safe to run twice. `devp doctor --fix` then mends what it found — installed-but-broken only |
|
|
398
|
+
| 🤖 **Self-installing automation** | OS-native scheduler (Task Scheduler, LaunchAgent, systemd user timer) and non-blocking Git hooks, installed at install time and restored after an upgrade. `auto_setup`, `auto_hooks`, `auto_daemon` or `DEV_PRUNE_NO_AUTO_SETUP=1` turn it off |
|
|
399
|
+
| ⚡ **0ms opt-out** | An `ignore.devprune.json` in a repository root is honoured by file presence alone — no read, no parse |
|
|
400
|
+
| 🔌 **`--json` on every reporting command** | `run`, `status`, `stats`, `trust` and `caches` each emit one versioned document on stdout, diagnostics on stderr. Built for scripts and agents |
|
|
401
|
+
| 🧠 **AI agent skill** | A token-lean `SKILL.md` embedded in the binary; `devp skill` exports it and prints onboarding prompts for Claude Code, Gemini Antigravity, Cursor, Windsurf, Copilot and OpenClaw |
|
|
402
|
+
| 🧰 **Editor extension** | Validates `.devprune.json` as you type and shows the workspace's reclaimable size in the status bar. `devp setup` offers to install it — once, only at a terminal — into VS Code, VSCodium, Cursor, Windsurf, Positron or Kiro, each from its own registry with the release `.vsix` as fallback. [docs/IDE_INTEGRATION.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/IDE_INTEGRATION.md) |
|
|
403
|
+
| 🖼️ **File manager icons** | `devp icon` registers `*.devprune.json` with the OS file manager — a real `shared-mime-info` type plus hicolor icons on Linux, a folder icon on Windows. It never edits your editor settings, `PATH` or shell startup files |
|
|
404
|
+
| 🚫 **No telemetry** | One optional unauthenticated `GET` to GitHub's public releases endpoint, at most weekly, no body and no identifier. Nothing else leaves the machine |
|
|
405
|
+
|
|
406
|
+
---
|
|
407
|
+
|
|
408
|
+
## Commands
|
|
409
|
+
|
|
410
|
+
| Command | Also | What it does |
|
|
411
|
+
| :--------------------- | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
412
|
+
| `devp init [PATHS]` | `scan`, `onboard` | Crawls directory trees for Git repositories and registers them, then runs the `setup` integration pass |
|
|
413
|
+
| `devp link [PATH]` | | Registers one repository |
|
|
414
|
+
| `devp unlink [PATH]` | `--missing` | Unregisters one; `--missing` drops every entry whose directory is gone, in one pass |
|
|
415
|
+
| `devp undo` | | Reverts the most recent `init` or `link` |
|
|
416
|
+
| `devp run [PATH]` | `--dry-run`, `--only`, `--skip`, `--except`, `--min-size`, `--json` | Prunes every registered repository, or one target |
|
|
417
|
+
| `devp status` | `--top N`, `--drift`, `--json` | Interactive dashboard; a plain table when there is no TTY. `--top N` shows only the N biggest repositories; `--drift` lists every environment holding packages its lockfile never recorded |
|
|
418
|
+
| `devp stats` | `--json` | What has already been reclaimed: lifetime total, prune passes, the last pass, and the biggest contributors |
|
|
419
|
+
| `devp completions` | `bash`, `zsh`, `fish`, `powershell`, `elvish` | Prints a shell completion script to stdout, generated from the same argument definitions the binary parses with |
|
|
420
|
+
| `devp caches` | `clear <manager\|all>`, `--json` | Sizes every package manager cache on the machine and prints the command that clears each. The report deletes nothing and nothing on a schedule ever will; `clear` empties one when you type it, after asking |
|
|
421
|
+
| `devp trust` | `--json` | What dev-prune may do on this machine: the guarantees the code enforces, then the scheduler, hooks and settings read live. Read-only |
|
|
422
|
+
| `devp restore [PATH]` | `--last-run` | Reinstalls dependencies for every project in a tree; `--last-run` undoes the last prune pass |
|
|
423
|
+
| `devp doctor [PATH]` | `--fix` | Diagnoses the installation, or one repository — ending with the single reason a pass would or would not touch it. `--fix` repairs what the checks found; it never performs a first-time install |
|
|
424
|
+
| `devp config [ACTION]` | `get`, `set`, `show`, `wizard`, `project`, `daemon`, `hook`, `icon` | Global settings, per-repository `.devprune.json`, scheduler, Git hooks, file manager icons |
|
|
425
|
+
| `devp setup` | `--status` | Installs any missing integration; `--status` only reports |
|
|
426
|
+
| `devp update` | `--offline`, `--install` | Prints the installed version, checks GitHub for a newer release, shows the upgrade command for your install channel; `--install` runs that upgrade through the channel that owns this copy |
|
|
427
|
+
| `devp skill` | `--agent <editor>` | Exports `SKILL.md` and prints AI agent onboarding prompts; `--agent` writes per-repository rules for 15 editors — Cursor, Windsurf, Antigravity, Cline, Roo, Kilo Code, Continue, Amazon Q, Kiro, Trae, Junie, Gemini CLI, Zed, Copilot or `AGENTS.md` |
|
|
428
|
+
| `devp man` | `--dir <dir>` | The manual as man pages, generated from the same argument definitions `--help` prints; alone it emits `devp(1)` to stdout, `--dir` writes the full set |
|
|
429
|
+
| `devp uninstall` | `--deep` | Removes the scheduler, hooks, both binaries and every other installed copy it can find on the machine; `--deep` also clears configuration |
|
|
430
|
+
| `devp -V` | | Version plus an environment audit: OS, architecture, config path, PATH activation |
|
|
431
|
+
|
|
432
|
+
`devp hook`, `devp daemon` and `devp icon` are shorthands for the `config` subcommands of
|
|
433
|
+
the same name, and `install` / `uninstall` / `on` / `off` work wherever `enable` /
|
|
434
|
+
`disable` do — so `devp hook install` and `devp config hook enable` are the same command.
|
|
435
|
+
A misspelled action is rejected rather than quietly reported as status.
|
|
436
|
+
|
|
437
|
+
`--help` is the manual: every command and every `config` subcommand carries long-form
|
|
438
|
+
help with worked examples — `devp run --help`, `devp config hook --help`, and so on at
|
|
439
|
+
every level — while `-h` keeps the short version.
|
|
440
|
+
|
|
441
|
+
Exit codes are a contract: `0` success, `1` failure, `2` unusable arguments. Full flag
|
|
442
|
+
list, every setting and the `--json` schema: **[docs/CLI_REFERENCE.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/CLI_REFERENCE.md)**.
|
|
443
|
+
|
|
444
|
+
---
|
|
445
|
+
|
|
446
|
+
## Supported ecosystems
|
|
447
|
+
|
|
448
|
+
Adapters detect the project, verify the lockfile, and own the bloat directories:
|
|
449
|
+
|
|
450
|
+
| Ecosystem | Detected by | Bloat | Verification (read-only) | Restore |
|
|
451
|
+
| :---------------- | :------------------------------------------------------- | :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- |
|
|
452
|
+
| **npm** | `package-lock.json` | `node_modules` | `npm ci --dry-run --ignore-scripts` | `npm ci` |
|
|
453
|
+
| **pnpm** | `pnpm-lock.yaml` | `node_modules` | `pnpm install --lockfile-only --frozen-lockfile` | `pnpm install --frozen-lockfile` |
|
|
454
|
+
| **Yarn** | `yarn.lock` | `node_modules` | `yarn install --immutable --mode update-lockfile` (Berry); on Classic an existing `yarn.lock` is itself the proof | `yarn install --immutable` |
|
|
455
|
+
| **Bun** | `bun.lockb`, `bun.lock` | `node_modules` | `bun install --frozen-lockfile --dry-run --ignore-scripts` | `bun install --frozen-lockfile` |
|
|
456
|
+
| **uv** (Python) | `uv.lock`, `[tool.uv]` in `pyproject.toml` | `.venv` | `uv lock --locked` | `uv sync` |
|
|
457
|
+
| **Poetry** (Python) | `poetry.lock`, `[tool.poetry]` in `pyproject.toml` | `.venv` | `poetry check --lock`, plus no installed package the lockfile never recorded | `poetry install` |
|
|
458
|
+
| **PDM** (Python) | `pdm.lock`, `[tool.pdm]` or `pdm.backend` in `pyproject.toml` | `.venv`, `__pypackages__` | `pdm lock --check` | `pdm install` |
|
|
459
|
+
| **Pipenv** (Python) | `Pipfile` | `.venv` *(in-project installs only)* | `pipenv verify` | `pipenv install --deploy` |
|
|
460
|
+
| **venv** (Python) | `requirements.txt` + a directory containing `pyvenv.cfg` | every directory containing `pyvenv.cfg` | `requirements.txt` must exist and list at least one package | `python -m venv .venv && pip install -r requirements.txt` |
|
|
461
|
+
| **Cargo** (Rust) | `Cargo.toml` | `target` | `cargo metadata --locked` | *(rebuilt by the next `cargo build`)* |
|
|
462
|
+
| **Go** | `go.mod` | `vendor` | `go mod download` | `go mod vendor` |
|
|
463
|
+
| **Composer** (PHP) | `composer.json` | `vendor` | `composer validate --no-check-publish --no-check-all` | `composer install` |
|
|
464
|
+
| **Bundler** (Ruby) | `Gemfile` | `vendor/bundle` *(vendored installs only)* | `bundle lock --check` | `bundle install` |
|
|
465
|
+
| **CocoaPods** (Apple) | `Podfile` | `Pods` | `Podfile.lock` carries its `SPEC CHECKSUMS` section and is no older than the `Podfile` | `pod install` |
|
|
466
|
+
| **Mix** (Elixir) | `mix.exs` | `deps` | `mix.lock` is a complete Elixir map and no older than `mix.exs` | `mix deps.get` |
|
|
467
|
+
| **Gradle** *(opt-in)* | `build.gradle[.kts]`, `settings.gradle[.kts]` | `build`, `.gradle` | manifest present and readable — the rebuild-from-source proof | *(rebuilt by the next `./gradlew build`)* |
|
|
468
|
+
| **Maven** *(opt-in)* | `pom.xml` | `target` | `pom.xml` parses as a Maven manifest | *(rebuilt by the next `mvn package`)* |
|
|
469
|
+
| **SwiftPM** *(opt-in)* | `Package.swift` | `.build` | `Package.swift` declares a `Package(` — the rebuild-from-source proof | *(rebuilt by the next `swift build`)* |
|
|
470
|
+
|
|
471
|
+
A required binary that is missing is a reason to skip, never a reason to delete: if `npm`
|
|
472
|
+
is not on `PATH`, the `node_modules` it owns is left exactly where it is.
|
|
473
|
+
|
|
474
|
+
The three build-tool adapters ship **disabled**, because a build tree is regenerated
|
|
475
|
+
by recompiling, not downloading — it costs more to get back. `devp config set
|
|
476
|
+
enable_gradle true` / `enable_maven true` / `enable_swift true` switches them on, and
|
|
477
|
+
their candidates wait for `build_idle_days` (60 by default), applied as the *maximum*
|
|
478
|
+
of it and `idle_days` — the build-tool gate only ever makes pruning later, never
|
|
479
|
+
earlier.
|
|
480
|
+
|
|
481
|
+
Bundler and Pipenv claim only the install that lives *inside* the repository: the
|
|
482
|
+
`vendor/bundle` a project gets from `bundle config set path vendor/bundle`, and the
|
|
483
|
+
`.venv` that appears when `PIPENV_VENV_IN_PROJECT` is set. Both tools default to a
|
|
484
|
+
shared store under your home directory instead, and dev-prune does not go near those at
|
|
485
|
+
all: a shared gem home or virtualenv directory is where other projects' dependencies are
|
|
486
|
+
*installed*, not a cache, and no single lockfile could prove its contents recoverable.
|
|
487
|
+
For the same reason Composer leaves `vendor/` alone entirely when a `vendor/bundle` is
|
|
488
|
+
sitting inside it: no `composer install` puts those gems back.
|
|
489
|
+
|
|
490
|
+
Any adapter can be switched off outright with `devp config set disabled_adapters
|
|
491
|
+
<names>` — a disabled adapter is not detected, not counted by `stats`, not probed
|
|
492
|
+
for by `doctor` and never pruned, exactly as if that ecosystem were not installed.
|
|
493
|
+
|
|
494
|
+
> [!TIP]
|
|
495
|
+
> Adding an ecosystem is documented end to end in
|
|
496
|
+
> [docs/ADDING_ADAPTERS.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/ADDING_ADAPTERS.md) — trait, registration, tests.
|
|
497
|
+
|
|
498
|
+
### Repositories with more than one ecosystem
|
|
499
|
+
|
|
500
|
+
A repository is not assumed to be one project. dev-prune walks the root and up to
|
|
501
|
+
`scan_depth` levels below it — six by default, `devp config set scan_depth N` to change
|
|
502
|
+
it, or `"scan_depth"` in a repository's `.devprune.json` for just that tree. Every
|
|
503
|
+
directory a package manager recognises is verified and pruned on its own terms. All three
|
|
504
|
+
of these work:
|
|
505
|
+
|
|
506
|
+
```
|
|
507
|
+
monorepo/ monorepo/ monorepo/
|
|
508
|
+
├── package-lock.json ├── frontend/ ├── Cargo.toml
|
|
509
|
+
├── uv.lock │ └── pnpm-lock.yaml ├── web/
|
|
510
|
+
└── Cargo.toml ├── services/api/ │ └── package-lock.json
|
|
511
|
+
│ └── uv.lock └── scripts/
|
|
512
|
+
three managers, one root └── tools/cli/ └── requirements.txt
|
|
513
|
+
└── Cargo.toml
|
|
514
|
+
root + nested, mixed
|
|
515
|
+
one manager per subtree
|
|
516
|
+
```
|
|
517
|
+
|
|
518
|
+
Results are reported by repository-relative path, so a monorepo reads unambiguously:
|
|
519
|
+
|
|
520
|
+
```
|
|
521
|
+
• MyMonorepo → frontend/node_modules (412.7 MiB) [pnpm]
|
|
522
|
+
• MyMonorepo → services/api/.venv (188.2 MiB) [uv]
|
|
523
|
+
• MyMonorepo → tools/cli/target (1.4 GiB) [cargo]
|
|
524
|
+
```
|
|
525
|
+
|
|
526
|
+
The walk never descends into `node_modules`, `target`, `vendor`, virtual environments,
|
|
527
|
+
hidden directories, or nested repositories — a submodule is pruned as itself, never as
|
|
528
|
+
part of its parent.
|
|
529
|
+
|
|
530
|
+
When npm, pnpm, yarn and bun all claim the same `node_modules`, exactly one is chosen,
|
|
531
|
+
strongest signal first:
|
|
532
|
+
|
|
533
|
+
1. the `packageManager` field in `package.json`,
|
|
534
|
+
2. the bookkeeping files inside the installed tree (`node_modules/.pnpm`,
|
|
535
|
+
`.yarn-state.yml`, `.package-lock.json`) — whoever built what is actually on disk,
|
|
536
|
+
3. the most recently written lockfile.
|
|
537
|
+
|
|
538
|
+
For Python, uv or Poetry takes the environment whenever it recognises the project —
|
|
539
|
+
between the two, whichever one's lockfile is actually on disk wins — and the
|
|
540
|
+
`requirements.txt` adapter handles everything else.
|
|
541
|
+
|
|
542
|
+
---
|
|
543
|
+
|
|
544
|
+
## Configuration
|
|
545
|
+
|
|
546
|
+
Global settings live in `%APPDATA%\dev-prune` (Windows),
|
|
547
|
+
`~/Library/Application Support/dev-prune` (macOS) and `$XDG_CONFIG_HOME/dev-prune`
|
|
548
|
+
(Linux). `devp config wizard` opens all of them in a full-screen configurator, and runs itself
|
|
549
|
+
once on a first install — so the defaults are something you agreed to rather than
|
|
550
|
+
inherited — and again after an upgrade adds a setting you have never been shown.
|
|
551
|
+
|
|
552
|
+
| Key | Default | Meaning |
|
|
553
|
+
| :--------------------------------------------------------- | :-------: | :---------------------------------------------------------------------------------- |
|
|
554
|
+
| `idle_days` | `15` | How long a repository must be untouched to become a candidate |
|
|
555
|
+
| `min_size_mb` | `0` | Smallest bloat directory worth deleting; `0` disables the floor |
|
|
556
|
+
| `scan_depth` | `6` | Levels below a repository root that discovery descends |
|
|
557
|
+
| `require_confirmation` | `true` | Whether a pass asks before deleting |
|
|
558
|
+
| `allow_manifest_rewrite` | `false` | Whether verification may *repair* a drifted lockfile instead of refusing |
|
|
559
|
+
| `command_timeout_secs` | `600` | Ceiling on any one package manager command |
|
|
560
|
+
| `auto_setup` · `auto_daemon` · `auto_hooks` | `true` | Whether the integration pass may run unattended, and what it may install |
|
|
561
|
+
| `auto_hooks_chain` | `false` | Whether it may take a `core.hooksPath` another tool holds, forwarding every hook on |
|
|
562
|
+
| `check_interval_days` | `2` | How often the OS scheduler runs a pass |
|
|
563
|
+
| `update_check` | `true` | Whether the periodic release check runs |
|
|
564
|
+
| `update_check_interval_days` · `update_check_timeout_secs` | `7` · `5` | Minimum gap between checks, and how long one may hang |
|
|
565
|
+
| `enable_gradle` · `enable_maven` · `enable_swift` | `false` | Turn on an opt-in build-tool adapter; `build_idle_days` (`60`) gates all three |
|
|
566
|
+
| `disabled_adapters` | *(none)* | Adapters to leave alone entirely, by name — as if that ecosystem were not installed |
|
|
567
|
+
|
|
568
|
+
Three of them — `idle_days` (as `override_idle_days`), `min_size_mb` and `scan_depth` —
|
|
569
|
+
also take a per-repository form in that project's `.devprune.json`, where they win for
|
|
570
|
+
that tree only. The rest are deliberately global: a project can commit its
|
|
571
|
+
`.devprune.json`, and a repository you have never read should not be able to grant itself
|
|
572
|
+
permission to have its manifests rewritten during an unattended pass.
|
|
573
|
+
|
|
574
|
+
An out-of-range value is rejected with the range in the message rather than silently
|
|
575
|
+
clamped. `scan_depth` included: `config set` accepts `1`–`32` and refuses anything else
|
|
576
|
+
outright — the clamp to that range survives only as the backstop for a hand-edited
|
|
577
|
+
config file.
|
|
578
|
+
|
|
579
|
+
---
|
|
580
|
+
|
|
581
|
+
## Background automation
|
|
582
|
+
|
|
583
|
+
Installation registers an OS-native scheduler — Windows Task Scheduler, a macOS
|
|
584
|
+
LaunchAgent, or a systemd user timer — that runs a pass every `check_interval_days`, plus
|
|
585
|
+
non-blocking `post-commit`, `post-checkout` and `post-merge` Git hooks that register new
|
|
586
|
+
repositories as you visit them. Both are reinstated after an upgrade if anything went
|
|
587
|
+
missing.
|
|
588
|
+
|
|
589
|
+
```bash
|
|
590
|
+
devp setup --status # what is installed, what is not, and why
|
|
591
|
+
devp config set auto_setup false # stop the unattended pass entirely
|
|
592
|
+
devp uninstall # remove the scheduler, hooks and the devp link
|
|
593
|
+
```
|
|
594
|
+
|
|
595
|
+
Git allows exactly one global `core.hooksPath`, so a tool holding it shuts every other one
|
|
596
|
+
out machine-wide. `devp hook install --chain` takes the slot and forwards each hook on to
|
|
597
|
+
the tool it displaced — husky, pre-commit and lefthook keep firing, in order, with their
|
|
598
|
+
own exit codes. It is opt-in, because rewiring another tool's Git configuration unasked is
|
|
599
|
+
not something an install should do.
|
|
600
|
+
|
|
601
|
+
Full decision flow: [docs/BACKGROUND_AUTOMATION.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/BACKGROUND_AUTOMATION.md).
|
|
602
|
+
|
|
603
|
+
---
|
|
604
|
+
|
|
605
|
+
## How it compares
|
|
606
|
+
|
|
607
|
+
| | `dev-prune` | `npkill` | `cargo-clean-all` | `pyclean` | `git clean` | `dust` / `ncdu` | BleachBit |
|
|
608
|
+
| :---------------------------------------- | :-------------------------: | :------: | :---------------: | :-------: | :-------------: | :-------------: | :-------: |
|
|
609
|
+
| Ecosystems | **JS/TS, Python, Rust, Go** | Node | Rust | Python | untracked files | — | OS caches |
|
|
610
|
+
| Many projects per repository | **✓** | ✗ | ✗ | ✗ | n/a | n/a | ✗ |
|
|
611
|
+
| `.git` boundary enforced | **✓** | ✗ | ✓ | ✗ | ✓ | ✗ | ✗ |
|
|
612
|
+
| Lockfile verified before deleting | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
613
|
+
| Commit log **and** `mtime` activity check | **✓** | ✗ | `mtime` only | ✗ | ✗ | ✗ | ✗ |
|
|
614
|
+
| One-command restore | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
615
|
+
| Undo the last pass | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
616
|
+
| Background scheduler | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
617
|
+
| Git hook auto-registration | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
618
|
+
| Per-repository config + 0ms opt-out | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
619
|
+
| Machine-readable `--json` | **✓** | ✗ | ✗ | ✗ | ✗ | partial | ✗ |
|
|
620
|
+
| AI agent skill | **✓** | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
|
|
621
|
+
| Runtime required | **none** (static binary) | Node.js | none | Python | none | none | Python |
|
|
622
|
+
|
|
623
|
+
Longer analysis: [docs/MARKET_ANALYSIS.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/MARKET_ANALYSIS.md).
|
|
624
|
+
|
|
625
|
+
---
|
|
626
|
+
|
|
627
|
+
## Architecture
|
|
628
|
+
|
|
629
|
+
```mermaid
|
|
630
|
+
flowchart TD
|
|
631
|
+
UserCLI["CLI / TUI Interface<br/>(devp / dev-prune)"] --> Registry["Global Registry<br/>(~/.config/dev-prune/registry.json)"]
|
|
632
|
+
UserCLI --> Engine["Prune Engine"]
|
|
633
|
+
|
|
634
|
+
Engine --> FastIgnore{ignore.devprune.json?}
|
|
635
|
+
FastIgnore -->|Exists| Skip["Skip Repo O(1) 0ms"]
|
|
636
|
+
FastIgnore -->|Missing| PerRepoConfig["Read .devprune.json"]
|
|
637
|
+
|
|
638
|
+
PerRepoConfig --> GitScanner["Git Scanner & Activity Solver<br/>(.git commits + mtime fallback)"]
|
|
639
|
+
Engine --> PreCheck["Required Ecosystem Binary Pre-Checker"]
|
|
640
|
+
Engine --> Adapters["Multi-Ecosystem Adapters"]
|
|
641
|
+
|
|
642
|
+
Adapters --> NPM["npm (package-lock.json -> node_modules)"]
|
|
643
|
+
Adapters --> PNPM["pnpm (pnpm-lock.yaml -> node_modules)"]
|
|
644
|
+
Adapters --> Yarn["yarn (yarn.lock -> node_modules)"]
|
|
645
|
+
Adapters --> Bun["bun (bun.lock -> node_modules)"]
|
|
646
|
+
Adapters --> UV["uv (uv.lock -> .venv)"]
|
|
647
|
+
Adapters --> Venv["venv (requirements.txt -> venv)"]
|
|
648
|
+
Adapters --> Cargo["cargo (Cargo.lock -> target)"]
|
|
649
|
+
Adapters --> Go["go (go.sum -> vendor)"]
|
|
650
|
+
|
|
651
|
+
Adapters --> LockfileCheck{"Lockfile Verification<br/>& Two-Tier Sync"}
|
|
652
|
+
LockfileCheck -->|Success / Present| Prune["Safe Deletion of Bloat Dirs"]
|
|
653
|
+
LockfileCheck -->|Failed & Missing| Abort["Abort Deletion & Log Fix Snippet"]
|
|
654
|
+
|
|
655
|
+
Daemon["OS Background Daemon Scheduler<br/>(Task Scheduler / LaunchAgent / systemd)"] -->|Every 2 Days| Engine
|
|
656
|
+
GitHooks["Git Auto-Registration Hooks<br/>(post-commit / post-checkout / post-merge)"] -->|On Git Activity| Registry
|
|
657
|
+
```
|
|
658
|
+
|
|
659
|
+
- **Registry** — Serde-backed, written atomically, holding registered paths and settings.
|
|
660
|
+
- **Engine** — coordinates activity discovery, verification and space calculation.
|
|
661
|
+
- **FastIgnore** — presence check for `ignore.devprune.json`; no read, no parse.
|
|
662
|
+
- **GitScanner** — `git log` timestamps plus source-file `mtime`.
|
|
663
|
+
- **PreCheck** — confirms the package manager binaries a pass will actually need.
|
|
664
|
+
- **Adapters** — one per ecosystem, each owning detection, verification and restore.
|
|
665
|
+
- **LockfileCheck** — the gate; failure aborts the deletion and prints the exact fix command.
|
|
666
|
+
- **Daemon / GitHooks** — the unattended pass, and registration as you work.
|
|
667
|
+
|
|
668
|
+
Deeper: [docs/ARCHITECTURE.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/ARCHITECTURE.md) ·
|
|
669
|
+
[HLD](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/architecture/HLD.md) · [LLD](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/architecture/LLD.md).
|
|
670
|
+
|
|
671
|
+
---
|
|
672
|
+
|
|
673
|
+
## Documentation
|
|
674
|
+
|
|
675
|
+
| | |
|
|
676
|
+
| :------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------ |
|
|
677
|
+
| [Documentation hub](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/README.md) | Index of everything below |
|
|
678
|
+
| [CLI reference](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/CLI_REFERENCE.md) | Every command, flag, setting, exit code and `--json` document |
|
|
679
|
+
| [Safety invariants](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/SAFETY_INVARIANTS.md) | The seven guarantees, and why each exists |
|
|
680
|
+
| [Architecture](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/ARCHITECTURE.md) · [HLD](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/architecture/HLD.md) · [LLD](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/architecture/LLD.md) | How it is built |
|
|
681
|
+
| [Background automation](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/BACKGROUND_AUTOMATION.md) | Schedulers, hooks, chaining, and turning it all off |
|
|
682
|
+
| [IDE & editor integration](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/IDE_INTEGRATION.md) | The extension, schema IntelliSense, and every editor it works in |
|
|
683
|
+
| [Adding an adapter](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/ADDING_ADAPTERS.md) | End-to-end tutorial for a new ecosystem |
|
|
684
|
+
| [Releases & manual install](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/RELEASES_AND_MANUAL_INSTALL.md) · [Distribution](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/DISTRIBUTION.md) | Every install channel, and building from source |
|
|
685
|
+
| [Troubleshooting](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/troubleshooting/README.md) | Symptom-first, with the fix for each |
|
|
686
|
+
| [Privacy](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/PRIVACY.md) | The one network request, in full |
|
|
687
|
+
| [Market analysis](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/MARKET_ANALYSIS.md) | Where this sits among the alternatives |
|
|
688
|
+
| [Contributing](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/CONTRIBUTING.md) · [Security policy](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/SECURITY.md) · [Changelog](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/CHANGELOG.md) | |
|
|
689
|
+
|
|
690
|
+
---
|
|
691
|
+
|
|
692
|
+
## License & privacy
|
|
693
|
+
|
|
694
|
+
Copyright 2026 VKrishna04. Licensed under the Apache License, Version 2.0 — see
|
|
695
|
+
[LICENSE.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/LICENSE.md). Every source file carries an
|
|
696
|
+
[SPDX](https://spdx.dev/) identifier, so automated licence scanners see the same
|
|
697
|
+
answer the file header does.
|
|
698
|
+
|
|
699
|
+
> [!IMPORTANT]
|
|
700
|
+
> **No analytics, no diagnostics, no usage data** — none collected, none sent. Your
|
|
701
|
+
> workspace structure, directory paths and repository names never leave the machine.
|
|
702
|
+
>
|
|
703
|
+
> `dev-prune` makes exactly one network request: an unauthenticated `GET` to GitHub's
|
|
704
|
+
> public releases endpoint, to tell you when a newer version exists. It has no body,
|
|
705
|
+
> carries no identifier, and runs at most once a week. Turn it off with `devp config set
|
|
706
|
+
> update_check false`. Full detail in [docs/PRIVACY.md](https://github.com/Life-Experimentalist/dev-prune/blob/v1.4.0/docs/PRIVACY.md).
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
dev_prune-1.4.0.data/scripts/dev-prune.exe,sha256=x0worIiSyhwR-2u3JRdPVQagcL3xkwDke5z2lN0-CLQ,4496896
|
|
2
|
+
dev_prune-1.4.0.data/scripts/devp.exe,sha256=x0worIiSyhwR-2u3JRdPVQagcL3xkwDke5z2lN0-CLQ,4496896
|
|
3
|
+
dev_prune-1.4.0.dist-info/METADATA,sha256=sv8PQkw646eft-UhSeUtSG73vNadzhXCQCmuW6pymas,55996
|
|
4
|
+
dev_prune-1.4.0.dist-info/WHEEL,sha256=kBmC1QGvdZute3uYc3DPVimhIq7rhWJR9RoKeXy14iQ,99
|
|
5
|
+
dev_prune-1.4.0.dist-info/licenses/LICENSE.md,sha256=QCex48BwRxWq2zE2T-nUdkK6tS1xOAoQKfTjqcGT-u4,11340
|
|
6
|
+
dev_prune-1.4.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
6
|
+
|
|
7
|
+
1. Definitions.
|
|
8
|
+
|
|
9
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
10
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
11
|
+
|
|
12
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
13
|
+
the copyright owner that is granting the License.
|
|
14
|
+
|
|
15
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
16
|
+
other entities that control, are controlled by, or are under common
|
|
17
|
+
control with that entity. For the purposes of this definition,
|
|
18
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
19
|
+
direction or management of such entity, whether by contract or
|
|
20
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
21
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
22
|
+
|
|
23
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
24
|
+
exercising permissions granted by this License.
|
|
25
|
+
|
|
26
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
27
|
+
including but not limited to software source code, documentation
|
|
28
|
+
source, and configuration files.
|
|
29
|
+
|
|
30
|
+
"Object" form shall mean any form resulting from mechanical
|
|
31
|
+
transformation or translation of a Source form, including but
|
|
32
|
+
not limited to compiled object code, generated documentation,
|
|
33
|
+
and conversions to other media types.
|
|
34
|
+
|
|
35
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
36
|
+
Object form, made available under the License, as indicated by a
|
|
37
|
+
copyright notice that is included in or attached to the work
|
|
38
|
+
(an example is provided in the Appendix below).
|
|
39
|
+
|
|
40
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
41
|
+
form, that is based on (or derived from) the Work and for which the
|
|
42
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
43
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
44
|
+
of this License, Derivative Works shall not include works that remain
|
|
45
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
46
|
+
the Work and Derivative Works thereof.
|
|
47
|
+
|
|
48
|
+
"Contribution" shall mean any work of authorship, including
|
|
49
|
+
the original version of the Work and any modifications or additions
|
|
50
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
51
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
52
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
53
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
54
|
+
means any form of electronic, verbal, or written communication sent
|
|
55
|
+
to the Licensor or its representatives, including but not limited to
|
|
56
|
+
communication on electronic mailing lists, source code control systems,
|
|
57
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
58
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
59
|
+
excluding communication that is conspicuously marked or otherwise
|
|
60
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
61
|
+
|
|
62
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
63
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
64
|
+
subsequently incorporated within the Work.
|
|
65
|
+
|
|
66
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
67
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
68
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
69
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
70
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
71
|
+
Work and such Derivative Works in Source or Object form.
|
|
72
|
+
|
|
73
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
74
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
75
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
76
|
+
(except as stated in this section) patent license to make, have made,
|
|
77
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
78
|
+
where such license applies only to those patent claims licensable
|
|
79
|
+
by such Contributor that are necessarily infringed by their
|
|
80
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
81
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
82
|
+
institute patent litigation against any entity (including a
|
|
83
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
84
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
85
|
+
or contributory patent infringement, then any patent licenses
|
|
86
|
+
granted to You under this License for that Work shall terminate
|
|
87
|
+
as of the date such litigation is filed.
|
|
88
|
+
|
|
89
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
90
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
91
|
+
modifications, and in Source or Object form, provided that You
|
|
92
|
+
meet the following conditions:
|
|
93
|
+
|
|
94
|
+
(a) You must give any other recipients of the Work or
|
|
95
|
+
Derivative Works a copy of this License; and
|
|
96
|
+
|
|
97
|
+
(b) You must cause any modified files to carry prominent notices
|
|
98
|
+
stating that You changed the files; and
|
|
99
|
+
|
|
100
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
101
|
+
that You distribute, all copyright, patent, trademark, and
|
|
102
|
+
attribution notices from the Source form of the Work,
|
|
103
|
+
excluding those notices that do not pertain to any part of
|
|
104
|
+
the Derivative Works; and
|
|
105
|
+
|
|
106
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
107
|
+
distribution, then any Derivative Works that You distribute must
|
|
108
|
+
include a readable copy of the attribution notices contained
|
|
109
|
+
within such NOTICE file, excluding those notices that do not
|
|
110
|
+
pertain to any part of the Derivative Works, in at least one
|
|
111
|
+
of the following places: within a NOTICE text file distributed
|
|
112
|
+
as part of the Derivative Works; within the Source form or
|
|
113
|
+
documentation, if provided along with the Derivative Works; or,
|
|
114
|
+
within a display generated by the Derivative Works, if and
|
|
115
|
+
wherever such third-party notices normally appear. The contents
|
|
116
|
+
of the NOTICE file are for informational purposes only and
|
|
117
|
+
do not modify the License. You may add Your own attribution
|
|
118
|
+
notices within Derivative Works that You distribute, alongside
|
|
119
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
120
|
+
that such additional attribution notices cannot be construed
|
|
121
|
+
as modifying the License.
|
|
122
|
+
|
|
123
|
+
You may add Your own copyright statement to Your modifications and
|
|
124
|
+
may provide additional or different license terms and conditions
|
|
125
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
126
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
127
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
128
|
+
the conditions stated in this License.
|
|
129
|
+
|
|
130
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
131
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
132
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
133
|
+
this License, without any additional terms or conditions.
|
|
134
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
135
|
+
the terms of any separate license agreement you may have executed
|
|
136
|
+
with Licensor regarding such Contributions.
|
|
137
|
+
|
|
138
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
139
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
140
|
+
except as required for reasonable and customary use in describing the
|
|
141
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
142
|
+
|
|
143
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
144
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
145
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
146
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
147
|
+
implied, including, without limitation, any warranties or conditions
|
|
148
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
149
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
150
|
+
appropriateness of using or redistributing the Work and assume any
|
|
151
|
+
risks associated with Your exercise of permissions under this License.
|
|
152
|
+
|
|
153
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
154
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
155
|
+
unless required by applicable law (such as deliberate and grossly
|
|
156
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
157
|
+
liable to You for damages, including any direct, indirect, special,
|
|
158
|
+
incidental, or consequential damages of any character arising as a
|
|
159
|
+
result of this License or out of the use or inability to use the
|
|
160
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
161
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
162
|
+
other commercial damages or losses), even if such Contributor
|
|
163
|
+
has been advised of the possibility of such damages.
|
|
164
|
+
|
|
165
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
166
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
167
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
168
|
+
or other liability obligations and/or rights consistent with this
|
|
169
|
+
License. However, in accepting such obligations, You may act only
|
|
170
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
171
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
172
|
+
defend, and hold each Contributor harmless for any liability
|
|
173
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
174
|
+
of your accepting any such warranty or additional liability.
|
|
175
|
+
|
|
176
|
+
END OF TERMS AND CONDITIONS
|
|
177
|
+
|
|
178
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
179
|
+
|
|
180
|
+
To apply the Apache License to your work, attach the following
|
|
181
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
182
|
+
replaced with your own identifying information. (Don't include
|
|
183
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
184
|
+
comment syntax for the file format. We also recommend that a
|
|
185
|
+
file or class name and description of purpose be included on the
|
|
186
|
+
same "printed page" as the copyright notice for easier
|
|
187
|
+
identification within third-party archives.
|
|
188
|
+
|
|
189
|
+
Copyright 2026 VKrishna04
|
|
190
|
+
|
|
191
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
|
+
you may not use this file except in compliance with the License.
|
|
193
|
+
You may obtain a copy of the License at
|
|
194
|
+
|
|
195
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
196
|
+
|
|
197
|
+
Unless required by applicable law or agreed to in writing, software
|
|
198
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
199
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
200
|
+
See the License for the specific language governing permissions and
|
|
201
|
+
limitations under the License.
|