quotum 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sergey Padurets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# Quotum
+
+Quotum shows how much of your coding-agent subscriptions is left — Claude Code, Codex
+and Antigravity — on every machine you work on, in one place.
+
+This package is the Quotum agent: a small native program that asks the agents' own
+command-line clients for their limits. It never reads your tokens and makes no model
+requests.
+
+```sh
+npx quotum                        # measure once and print this machine's limits
+npx quotum connect https://hub…   # connect this machine to a Quotum hub with a one-time code
+npx quotum run                    # keep measuring and deliver to the hub
+npx quotum --help
+```
+
+Prebuilt for Linux (x64, arm64, any distribution), macOS (Intel, Apple silicon) and
+Windows (x64); npm installs only the binary for your platform.
+
+The dashboard (the hub), how it works and why: https://github.com/padurets/quotum

package/bin/quotum.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// Runs the quotum agent built for this platform. npm installs that binary from the
+// matching optional dependency (@quotum/<platform>-<arch>); nothing is downloaded here.
+'use strict';
+const {spawnSync} = require('node:child_process');
+
+const SUPPORTED = ['linux-x64', 'linux-arm64', 'darwin-x64', 'darwin-arm64', 'win32-x64'];
+const target = `${process.platform}-${process.arch}`;
+
+function fail(message) {
+  console.error(`quotum: ${message}`);
+  process.exit(1);
+}
+
+let binary;
+try {
+  binary = require.resolve(`@quotum/${target}/bin/quotum${process.platform === 'win32' ? '.exe' : ''}`);
+} catch {
+  fail(
+    SUPPORTED.includes(target)
+      ? `the binary for ${target} is not installed; reinstall without --omit=optional (or --no-optional).`
+      : `there is no prebuilt binary for ${target} yet (${SUPPORTED.join(', ')}); build it from source: https://github.com/padurets/quotum`,
+  );
+}
+
+const result = spawnSync(binary, process.argv.slice(2), {stdio: 'inherit'});
+if (result.error) fail(result.error.message);
+if (result.signal) process.kill(process.pid, result.signal);
+process.exitCode = result.status ?? 1;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "quotum",
+  "version": "0.1.0",
+  "description": "See how much of your coding-agent subscriptions is left (Claude Code, Codex, Antigravity) on every machine, in one place.",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "antigravity",
+    "usage",
+    "limits",
+    "quota",
+    "cli"
+  ],
+  "homepage": "https://github.com/padurets/quotum",
+  "bugs": "https://github.com/padurets/quotum/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/padurets/quotum.git",
+    "directory": "npm/quotum"
+  },
+  "license": "MIT",
+  "author": "Sergey Padurets",
+  "bin": {
+    "quotum": "bin/quotum.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@quotum/linux-x64": "0.1.0",
+    "@quotum/linux-arm64": "0.1.0",
+    "@quotum/darwin-x64": "0.1.0",
+    "@quotum/darwin-arm64": "0.1.0",
+    "@quotum/win32-x64": "0.1.0"
+  }
+}