packlight-cli 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+What changed in each release of packlight. The newest is first. Every release is also on
+[GitHub Releases](https://github.com/cooperism-lab/packlight/releases); choose Watch › Custom › Releases there to hear about new ones.
+
+## 0.1.1 (2026-10-10)
+
+- The savings line never shows more than 100% of your setup. Before, a fix plan larger than the measured
+  setup could show a share over 100%, in the report and in `packlight fix`.
+
+## 0.1.0 (2026-10-09)
+
+The first release, on npm as `packlight-cli`.
+
+- Measures the tokens each Claude Code and Codex session starts with, split by source: skill listing, MCP tool
+  names and instructions, hook text, agent descriptions, CLAUDE.md and AGENTS.md. For Codex the number is measured
+  from the input tokens Codex logs.
+- Shows which skills, agents, plugins, MCP servers and hooks you used, and which you never did, from your own
+  session logs. Runs offline and sends nothing.
+- `packlight fix` and the report's Fix it button archive everything unused since it was installed, after one
+  question. Items only you can remove (claude.ai connectors, app plugins, Codex config) come with the exact place
+  to turn them off.
+- `packlight restore` puts archived items back byte for byte. Skills installed by a suite like gstack are never
+  archived.
+- One report per agent: `report-claude-code.html` and `report-codex.html` in `~/.packlight`.

package/README.md

@@ -60,6 +60,10 @@ Planned releases:
 - **v0.2:** overlap detection, plus a packlight skill that rates items and writes "which one" cards. This is the public launch.
 - **v0.3:** Codex adapter.
 
+## What's new
+
+See [CHANGELOG.md](CHANGELOG.md), or [GitHub Releases](https://github.com/cooperism-lab/packlight/releases) to be told about new versions (Watch › Custom › Releases). `npx packlight-cli` always runs the newest version; a global install updates with `npm install -g packlight-cli`.
+
 ## Who made it
 
 Built by Cooper Kao ([cooperism-lab](https://github.com/cooperism-lab)). Issues and pull requests are welcome.

package/dist/cli.js

@@ -140,7 +140,7 @@ const KIND_WORD = { skill: ['skill', 'skills'], command: ['command', 'commands']
 const count = (n, kind) => `${n} ${KIND_WORD[kind]?.[n === 1 ? 0 : 1] ?? kind}`;
 /** "about 2k tokens less per session (10% of your setup; 7.9k characters)": tokens estimated at CHARS_PER_TOKEN. */
 const saving = (savedChars, setup) => {
-    const pct = setup ? (savedChars / setup) * 100 : 0;
+    const pct = setup ? Math.min(100, (savedChars / setup) * 100) : 0;
     return `about ${kchars(savedChars / CHARS_PER_TOKEN)} tokens less per session (${setup ? `${pct > 0 && pct < 1 ? 'under 1' : Math.round(pct)}% of your setup; ` : ''}${kchars(savedChars)} characters)`;
 };
 const kchars = (n) => (n >= 1000 ? `${(n / 1000).toFixed(1).replace(/\.0$/, '')}k` : String(n));

package/dist/report/client.js

@@ -67,7 +67,7 @@ export function clientMain() {
     // Tokens are estimated from characters (logs record characters): about 4 per token, the same as CHARS_PER_TOKEN in model.ts.
     const tokens = (c) => chars(c / 4);
     const setupTotal = () => { const l = data.sessionLoad; return !l ? 0 : l.measuredTokens ? l.measuredTokens * 4 : l.skillListing + l.mcpTools + l.mcpInstructions + l.hookStart + l.agents + (l.agentsMd ?? 0) + (l.pluginInstructions ?? 0); };
-    const share = (part, whole) => { const p = (part / whole) * 100; return p > 0 && p < 1 ? 'under 1%' : `${Math.round(p)}%`; };
+    const share = (part, whole) => { const p = Math.min(100, (part / whole) * 100); return p > 0 && p < 1 ? 'under 1%' : `${Math.round(p)}%`; };
     const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
     const tildify = (p) => (p.startsWith(data.home) ? `~${p.slice(data.home.length)}` : p);
     const live = document.getElementById('live');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "packlight-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "See what your coding agent carries, keep what you use, archive the rest.",
   "keywords": [
     "claude-code",
@@ -28,7 +28,8 @@
     "packlight": "dist/cli.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"