sparewise 0.3.0

package/LICENSE

@@ -0,0 +1,43 @@
+Sparewise — Proprietary Software License
+(DRAFT — to be reviewed and finalised by the owner before release)
+
+Copyright (c) 2026 Sparewise. All rights reserved.
+
+This software, including its source code, object code, documentation and all
+related files (the "Software"), is proprietary and confidential. It is
+licensed, not sold.
+
+1. Permission to use. You may install and use the Software, in the form the
+   owner distributes it, on computers you own or control, for personal or
+   business purposes, subject to any further terms published with a release.
+
+2. Restrictions. Unless the owner gives written permission, you may not:
+   a. copy, publish, distribute, sublicense, rent, lend or sell the Software or
+      any part of it;
+   b. modify the Software or create works based on it;
+   c. reverse engineer, decompile or disassemble the Software, except to the
+      extent the law where you live allows it despite this restriction;
+   d. remove or change any copyright, trademark or other notice in it.
+
+3. Source code. Access to the source code does not grant any of the rights
+   above. The source code is confidential and may only be used by people the
+   owner has authorised.
+
+4. Third-party components. The Software includes components owned by others,
+   each under its own license; see THIRD-PARTY-NOTICES.md. Those licenses
+   apply to those components.
+
+5. Earlier public release. A first prototype of this project was briefly
+   published under the MIT License. That grant applies only to that published
+   version; it does not extend to this or any later version.
+
+6. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO MERCHANTABILITY, FITNESS FOR
+   A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+7. Limitation of liability. IN NO EVENT SHALL THE OWNER BE LIABLE FOR ANY CLAIM,
+   DAMAGES OR OTHER LIABILITY ARISING FROM THE SOFTWARE OR ITS USE, TO THE
+   EXTENT THE LAW ALLOWS.
+
+8. Termination. This license ends automatically if you break its terms; you
+   must then stop using the Software and delete your copies.

package/README.md

@@ -0,0 +1,62 @@
+# sparewise
+
+See why your Windows drive is full, and free space safely. Developer and AI tool
+caches, local models, Docker and WSL disks, browser and editor caches, all from
+the command line, and as an MCP server for AI assistants.
+
+```
+npx sparewise
+```
+
+No account, no telemetry, no admin rights. Windows 10 and 11, x64 and ARM.
+
+```
+C:\  520 GB used of 932 GB  (56% full)
+
+  Docker Desktop data     77.0 GB   used 4 days ago
+  Ollama models           33.6 GB   used 5 months ago
+  Hugging Face cache      30.3 GB   used 6 months ago
+  npm cache               17.0 GB   used 3 days ago
+  uv cache                 4.9 GB   used 14 days ago
+```
+
+## Usage
+
+```
+npx sparewise                     scan and print
+npx sparewise overview            why the drive is full, in plain parts
+npx sparewise free 20GB           plan the smallest safe set of caches, confirm, apply
+npx sparewise plan --compress     shrink folders you have not used in a month
+npx sparewise undo <run-id>       put back what a run moved or compressed
+npx sparewise --export report.md  write a shareable report
+npx sparewise mcp                 run as an MCP server for AI assistants
+```
+
+Add `--json` to most commands for scripts and agents.
+
+## Safe by design
+
+- **Scanning changes nothing.**
+- **Every change asks first** and goes to the Recycle Bin or an undo window, so it can be put back. Sparewise never empties the Recycle Bin and never deletes permanently.
+- **Only caches that rebuild by themselves** are offered for removal, each with a rule-based safety verdict. Models, virtual disks, projects and your own files are reported with the right way to remove them, never removed by Sparewise.
+- **Files in use stay**, and the result says so.
+
+## For AI assistants
+
+`sparewise mcp` is an MCP server with tools for scanning, planning, freeing space and undo.
+An assistant can read and plan freely. It can change the disk only within limits you set
+(`%LocalAppData%\DevStorage\policy.json`, or Settings in the Sparewise window), and never permanently.
+
+```
+claude mcp add sparewise -- npx -y sparewise mcp
+codex mcp add sparewise -- npx -y sparewise mcp
+```
+
+## The window
+
+A full Windows app with the same engine: Smart Care, a drive map, reports and one-click
+connections for Claude, Cursor and VS Code. [Download it here](https://github.com/sparewise/sparewise/releases/latest).
+
+## Licence
+
+Free to use; proprietary. See LICENSE.

package/bin/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+'use strict';
+
+// Runs the Windows program for this machine (x64 or ARM), both shipped in this package.
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+const platforms = {
+  'win32-x64': 'sparewise.exe',
+  'win32-arm64': 'sparewise.exe',
+};
+
+const key = `${process.platform}-${process.arch}`;
+const executable = platforms[key];
+
+if (!executable) {
+  console.error(`Sparewise runs on Windows for now (this is ${key}).`);
+  console.error(`Supported: ${Object.keys(platforms).join(', ')}.`);
+  process.exit(1);
+}
+
+const binary = path.join(__dirname, "..", "vendor", key, executable);
+if (!require("fs").existsSync(binary)) {
+  console.error(`The Sparewise program for ${key} is missing from this package. Reinstall it.`);
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: 'inherit' });
+
+if (result.error) {
+  console.error(`Could not start ${path.basename(binary)}: ${result.error.message}`);
+  process.exit(1);
+}
+
+// A signal (Ctrl+C) ends the launcher the same way it ended the binary.
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "sparewise",
+  "version": "0.3.0",
+  "description": "See why your Windows drive is full and free space safely: developer and AI tool caches, models, Docker and WSL. Also an MCP server for AI assistants.",
+  "keywords": [
+    "mcp",
+    "windows",
+    "cache",
+    "cleanup",
+    "cli",
+    "disk",
+    "disk-space",
+    "docker",
+    "huggingface",
+    "node_modules",
+    "ollama",
+    "storage",
+    "wsl"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sparewise/sparewise.git"
+  },
+  "bin": {
+    "sparewise": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "vendor/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}