tachograph 0.1.1

package/README.md

@@ -0,0 +1,24 @@
+# tachograph
+
+A compact instrument cluster for your coding agents (**Claude Code** / **Codex**) —
+model, rate-limit usage (5-hour / weekly), and context window, at a glance.
+
+```sh
+npm install -g tachograph
+tacho                 # one-shot compact status
+tacho setup claude    # wire up the Claude Code statusLine
+```
+
+`npm install` downloads the prebuilt `tacho` binary for your platform from the
+matching [GitHub release](https://github.com/kosako/tachograph/releases). If no
+prebuilt binary fits your platform, install from source instead:
+
+```sh
+go install github.com/kosako/tachograph/cmd/tacho@latest
+```
+
+Full documentation: <https://github.com/kosako/tachograph>.
+
+## License
+
+[MIT](https://github.com/kosako/tachograph/blob/main/LICENSE)

package/asset.js

@@ -0,0 +1,32 @@
+// Maps the running platform to the GoReleaser release asset that carries the
+// matching `tacho` binary. Kept pure and dependency-free so it can be unit
+// tested without touching the network or filesystem.
+
+const PLATFORMS = { darwin: "darwin", linux: "linux", win32: "windows" };
+const ARCHES = { x64: "amd64", arm64: "arm64" };
+
+// assetFor returns { asset, binary } for the given Node platform/arch, or
+// throws with a clear message when the combination has no published build.
+function assetFor(platform, arch) {
+  const os = PLATFORMS[platform];
+  const goarch = ARCHES[arch];
+  if (!os || !goarch) {
+    throw new Error(
+      `tachograph: no prebuilt binary for ${platform}/${arch}. ` +
+        `Install from source instead: go install github.com/kosako/tachograph/cmd/tacho@latest`,
+    );
+  }
+  const ext = os === "windows" ? "zip" : "tar.gz";
+  return {
+    asset: `tachograph_${os}_${goarch}.${ext}`,
+    binary: os === "windows" ? "tacho.exe" : "tacho",
+  };
+}
+
+// downloadURL builds the GitHub release download URL for a version + asset.
+function downloadURL(version, asset) {
+  const tag = version.startsWith("v") ? version : `v${version}`;
+  return `https://github.com/kosako/tachograph/releases/download/${tag}/${asset}`;
+}
+
+module.exports = { assetFor, downloadURL, PLATFORMS, ARCHES };

package/bin/tacho.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// Launcher: exec the platform binary that postinstall placed next to this file,
+// forwarding args, stdio, and exit code.
+
+const path = require("path");
+const fs = require("fs");
+const { spawnSync } = require("child_process");
+
+const binary = process.platform === "win32" ? "tacho.exe" : "tacho";
+const binPath = path.join(__dirname, binary);
+
+if (!fs.existsSync(binPath)) {
+  console.error(
+    "tachograph: binary not found — the postinstall download may have failed.\n" +
+      "Reinstall (npm i -g tachograph), or install from source:\n" +
+      "  go install github.com/kosako/tachograph/cmd/tacho@latest",
+  );
+  process.exit(1);
+}
+
+const res = spawnSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+if (res.error) {
+  console.error(`tachograph: ${res.error.message}`);
+  process.exit(1);
+}
+process.exit(res.status === null ? 1 : res.status);

package/install.js

@@ -0,0 +1,54 @@
+// postinstall: download the tacho binary matching this platform from the
+// GitHub release for this package's version, and extract it into bin/.
+//
+// Archives are produced by GoReleaser (tar.gz everywhere except Windows zip).
+// We extract via the system `tar`, which is bsdtar on macOS/Windows (handles
+// both formats) and GNU tar on Linux (handles our tar.gz). This keeps the
+// package dependency-free.
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { execFileSync } = require("child_process");
+const { assetFor, downloadURL } = require("./asset");
+
+const { version } = require("./package.json");
+const binDir = path.join(__dirname, "bin");
+
+async function main() {
+  const { asset, binary } = assetFor(process.platform, process.arch);
+  const url = downloadURL(version, asset);
+
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok) {
+    throw new Error(`download failed: ${res.status} ${res.statusText} for ${url}`);
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "tacho-"));
+  const archive = path.join(tmp, asset);
+  fs.writeFileSync(archive, buf);
+
+  fs.mkdirSync(binDir, { recursive: true });
+  // bsdtar/GNU tar both extract by extension; -C lands the binary in bin/.
+  execFileSync("tar", ["-xf", archive, "-C", binDir], { stdio: "inherit" });
+  fs.rmSync(tmp, { recursive: true, force: true });
+
+  const binPath = path.join(binDir, binary);
+  if (!fs.existsSync(binPath)) {
+    throw new Error(`extracted archive but ${binary} not found in ${binDir}`);
+  }
+  if (process.platform !== "win32") {
+    fs.chmodSync(binPath, 0o755);
+  }
+  console.log(`tachograph: installed ${binary} ${version}`);
+}
+
+main().catch((err) => {
+  console.error(`\n${err.message}\n`);
+  console.error(
+    "You can install from source instead:\n" +
+      "  go install github.com/kosako/tachograph/cmd/tacho@latest\n",
+  );
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "tachograph",
+  "version": "0.1.1",
+  "description": "A compact instrument cluster for your coding agents (Claude Code / Codex). Shows model, rate-limit usage, and context at a glance.",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "statusline",
+    "rate-limit",
+    "cli"
+  ],
+  "homepage": "https://github.com/kosako/tachograph#readme",
+  "bugs": "https://github.com/kosako/tachograph/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kosako/tachograph.git",
+    "directory": "npm"
+  },
+  "license": "MIT",
+  "author": "kosako",
+  "bin": {
+    "tacho": "bin/tacho.js"
+  },
+  "files": [
+    "bin/tacho.js",
+    "install.js",
+    "asset.js"
+  ],
+  "scripts": {
+    "postinstall": "node install.js",
+    "test": "node test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}