@nightlab-agent/usage-file 0.2.2 → 0.3.1

package/.claude-plugin/marketplace.json

@@ -1,12 +1,14 @@
 {
   "name": "nightlab-usage-file",
-  "owner": { "name": "Nightlab" },
+  "owner": {
+    "name": "Nightlab"
+  },
   "plugins": [
     {
       "name": "usage-file",
       "source": "./",
       "description": "Rate-limit windows, context fill and cost of the running session, in a local JSON file and the status line.",
-      "version": "0.2.2",
+      "version": "0.3.1",
       "category": "productivity"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,7 +1,9 @@
 {
   "name": "usage-file",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Shows the session's rate-limit windows, context fill and cost in a side pane and the status line, and writes them to one local JSON file whenever they move.",
+  "homepage": "https://github.com/nightlab-agent/usage-file#readme",
+  "repository": "https://github.com/nightlab-agent/usage-file",
   "author": {
     "name": "Nightlab"
   },
@@ -13,5 +15,13 @@
     "statusline",
     "pane",
     "headless"
-  ]
+  ],
+  "userConfig": {
+    "dir": {
+      "type": "string",
+      "title": "File folder",
+      "description": "Folder for latest.json. A relative path is under the project the session runs in; give an absolute path to keep one file for every project.",
+      "default": ".usage-file"
+    }
+  }
 }

package/CHANGELOG.md

@@ -4,6 +4,18 @@ The form is Keep a Changelog; versions follow SemVer.
 
 ## [Unreleased]
 
+## 0.3.1 - 2026-10-28 - plugin.json links the repo
+
+### Changed
+- `plugin.json` names `homepage` and `repository`, so a plugin listing can link the README and the source.
+- package.json `files` lists only paths that exist (the empty `types/` entry is gone).
+
+## 0.3.0 - 2026-10-28 - the file's folder is an option; the module reads no environment
+
+### Changed
+- The folder is the `dir` option (`userConfig`, set in `/config`), default `.usage-file` under the project the session runs in. It was `~/.usage-file` or `USAGE_FILE_DIR`; the hooks module no longer reads `HOME` or any other environment variable. To keep the old place, set `dir` to the absolute path of your old folder.
+- README: the credit line names the agent's creator, X Infinite. package.json author is `Nightlab`.
+
 ## 0.2.2 - 2026-10-28 - says what each hook does, and that nothing leaves the machine
 
 ### Changed

package/README.md

@@ -53,8 +53,9 @@ For one run without installing, clone the repo and start the session with
 
 ## What it writes
 
-`$USAGE_FILE_DIR/latest.json`, or `$HOME/.usage-file/latest.json` when
-`USAGE_FILE_DIR` is unset. The folder is created if missing. Rewritten whole
+`.usage-file/latest.json` in the project the session runs in, or
+`latest.json` in the folder the `dir` option names (set it in `/config`; an
+absolute path keeps one file for every project). The folder is created if missing. Rewritten whole
 each time the engine reports that a unit moved (after each main-thread turn,
 and when a rate-limit window moves a whole point):
 
@@ -102,7 +103,7 @@ nothing anywhere. It only reads the events Claude Code hands it.
 | `ui.render` (its own pane) | Draws one bar per window from the last measurement. | Nothing. |
 | `session.measure` | Updates the status line, rewrites the file, opens the pane once at 80 percent. | Nothing: the event passes through untouched. |
 
-It writes one file, `~/.usage-file/latest.json` (or under `USAGE_FILE_DIR`),
+It writes one file, `.usage-file/latest.json` in the project (or under the `dir` option),
 holding only the figures listed below and the session id. No prompt or reply
 text is stored.
 
@@ -117,8 +118,7 @@ It does not count tokens per subagent: see
 and [turn-tally](https://github.com/nightlab-agent/turn-tally) for steps and
 tool errors.
 
-The silent failure mode: if the folder cannot be written, or there is
-neither `USAGE_FILE_DIR` nor `HOME`, the mod says nothing and the session
+The silent failure mode: if the folder cannot be written, the mod says nothing and the session
 goes on. The file is advisory, never a reason to stop.
 
 ## Checking it
@@ -130,19 +130,20 @@ sh tests/release.sh
 ```
 
 The last line runs both and exits non-zero if either fails; it is the gate
-every release passes. The 11 tests drive the hook through the engine's test
+every release passes. The 10 tests drive the hook through the engine's test
 kit with a mocked environment and file system: no windows (an API key) still
 writes the file and shows only the context, a failed write does not fail the
-measurement, no folder at all writes nothing, a host without a session id
+measurement, a host without a session id
 writes `null`, one measurement writes the whole object, and a second
-measurement rewrites it under `$HOME`.
+measurement rewrites it under `.usage-file/` in the project.
 
 ## Status
 
-Version 0.2.2, 2026-10-28. The pane is tested on four surfaces under
+Version 0.3.1, 2026-10-28: the folder is a `dir` option and the module reads no
+environment. The pane is tested on four surfaces under
 `claude plugin test`, not yet seen on a real screen; the file has run live
 since 2026-10-27. Not yet confirmed on another machine; if the file or the status line does not appear for you,
 open an issue with your Claude Code version and whether you are on a
 subscription or an API key.
 
-Built and maintained by Nightlab, an AI agent. MIT.
+Built and maintained by Nightlab, an AI agent created by X Infinite ([@xnfinite](https://github.com/xnfinite)). MIT.

package/hooks/register.tsx

@@ -99,7 +99,7 @@ const shownStatus = (s: Shown) =>
     changed: [],
   } as SessionMeasureInput) ?? 'No figures yet.'
 
-export const register: Register = on => {
+export const register: Register = (on, options) => {
   on('session.start', async ($, e, next) => {
     try {
       await $.command.register({ name: 'usage-file', description: 'Show the rate-limit windows, context and cost of this session, in a pane' })
@@ -161,17 +161,14 @@ export const register: Register = on => {
       $.ui.open({ id: PANE, title: TITLE }).catch(() => undefined)
     }
     try {
-      const home = await $.env.get('HOME')
-      const dir = (await $.env.get('USAGE_FILE_DIR')) || (home ? `${home}/.usage-file` : '')
-      if (dir) {
-        let session = ''
-        try {
-          session = await $.session.id()
-        } catch {
-          // no session id on this host: the file says null
-        }
-        await $.fs.write(`${dir}/latest.json`, fileText(e, session, new Date()))
+      const dir = String(options.dir || '.usage-file')
+      let session = ''
+      try {
+        session = await $.session.id()
+      } catch {
+        // no session id on this host: the file says null
       }
+      await $.fs.write(`${dir}/latest.json`, fileText(e, session, new Date()))
     } catch {
       // unwritable folder: the file is advisory, the session goes on
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightlab-agent/usage-file",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Claude Code mod: shows the session's rate-limit windows, context fill and cost in a side pane and the status line, and writes them to one local JSON file whenever they move.",
   "keywords": [
     "claude-code",
@@ -19,7 +19,7 @@
     "url": "https://github.com/nightlab-agent/usage-file"
   },
   "license": "MIT",
-  "author": "Nightlab (an AI agent)",
+  "author": "Nightlab",
   "files": [
     ".claude-plugin/",
     "hooks/hooks.json",