@inbrace-tech/tokenline 1.1.2 → 1.2.0

package/README.md

@@ -3,7 +3,7 @@
 > See your AI coding costs in real time. Tokenline adds context usage, prompt-cache savings, TTL countdown and rate-limit pacing to Claude Code and Gemini CLI.
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)
-![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20WSL2-blue)
+![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20WSL2%20%7C%20macOS-blue)
 ![Shell](https://img.shields.io/badge/shell-bash%204%2B-lightgrey)
 
 ## Quickstart
@@ -78,14 +78,16 @@ If `tokenline` reveals you are getting 1-hour cache writes, keep in mind they bu
 
 ## Requirements
 
-v1 targets **Linux / WSL2**:
+Runs on **Linux / WSL2** and **macOS**:
 
-- `bash` 4 or newer
+- `bash` 4 or newer — macOS ships 3.2, so `brew install bash`
 - [`jq`](https://jqlang.github.io/jq/)
-- GNU coreutils (`date -d`, `stat -c`)
+- `date` and `stat` — GNU (`-d` / `-c`) or BSD (`-j` / `-f`); both are handled
 
-> macOS and Windows support are on the [roadmap](#roadmap). `install.sh` checks all of
-> the above and tells you exactly what's missing.
+On macOS: `brew install bash jq`. BSD `date`/`stat` work as-is; no `coreutils` needed.
+
+> Windows support is on the [roadmap](#roadmap). `install.sh` checks all of the
+> above and tells you exactly what's missing.
 
 ## Advanced Installation
 
@@ -139,11 +141,11 @@ On every refresh the host CLI pipes a JSON snapshot of the session to the script
 | Blank statusline, or `[tokenline] jq not found` | Install `jq` (`apt install jq` / `brew install jq`), then re-run `./install.sh`. |
 | Cache shows `COLD` immediately | Normal right after a long idle gap — the cache window has elapsed. It goes `HOT` again on your next turn. |
 | Colors look wrong / show escape codes | Your terminal must support 256-color ANSI. Most modern terminals do; check your `$TERM`. |
-| Nothing renders on macOS | Expected on v1 — macOS uses BSD `date`/`stat`. See the [roadmap](#roadmap). |
+| Nothing renders on macOS | Install `bash` 4+ and `jq`: `brew install bash jq`. Stock bash 3.2 lacks `mapfile`. |
 
 ## Roadmap
 
-- [ ] macOS support (BSD `date`/`stat`, bash 3.2 fallback)
+- [x] macOS support (BSD `date`/`stat`, Homebrew bash)
 - [ ] Windows support (Git Bash / PowerShell)
 - [ ] Configurable colors and thresholds via `TOKENLINE_*` env vars
 

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-"use strict";var A=require("fs"),D=require("path");var j=require("os"),c=require("path"),J=(0,c.join)(__dirname,"..","tokenline.sh"),_=e=>e.global?(0,c.join)((0,j.homedir)(),".claude"):(0,c.resolve)(".claude"),$=e=>e.dir?(0,c.resolve)(e.dir,"tokenline.sh"):(0,c.join)(_(e),"tokenline.sh"),d=e=>(0,c.join)(_(e),"settings.json"),q=e=>e.includes(" ")?`bash "${e}"`:`bash ${e}`;var p=require("fs");function f(e){if(!(0,p.existsSync)(e))return{exists:!1,data:{}};let t=(0,p.readFileSync)(e,"utf8");if(t.trim()==="")return{exists:!0,data:{},raw:t};try{return{exists:!0,data:JSON.parse(t),raw:t}}catch{return{exists:!0,data:null,raw:t}}}function x(e){let t=`${e}.bak`;return(0,p.copyFileSync)(e,t),t}var S=e=>typeof e=="string"&&/tokenline\.sh/.test(e);var O=require("child_process"),I=require("os");var E=!!process.stdout.isTTY&&!process.env.NO_COLOR,h=(e,t)=>E?`\x1B[${e}m${t}\x1B[0m`:t,r=e=>h("1",e),W=e=>h("2",e),b=e=>h("32",e),G=e=>h("31",e),K=e=>h("33",e),g=e=>console.log(`${b("\u2713")} ${e}`),i=e=>console.log(`${K("!")} ${e}`),u=e=>console.error(`${G("\u2717")} ${e}`),s=e=>console.log(`${W("\u2192")} ${e}`);function w(){let e=(0,I.platform)();return e==="linux"?(g(`platform: ${e} (supported)`),!0):(i(`platform: ${e} \u2014 v1 targets Linux/WSL2; the bash statusline likely won't render yet (see roadmap). Use --force to install anyway.`),!1)}function v(){let e=(0,O.spawnSync)("jq",["--version"],{encoding:"utf8"});return e.status===0?(g(String(e.stdout).trim()),!0):(i("jq not found \u2014 required at runtime. Install it (apt install jq / brew install jq)."),!1)}function C(){let e=(0,O.spawnSync)("bash",["--version"],{encoding:"utf8"});if(e.status===0){let t=String(e.stdout).match(/version (\d+)\.(\d+)/);return t&&Number(t[1])>=4?(g(`bash ${t[1]}.${t[2]}`),!0):(i(`bash ${t?`${t[1]}.${t[2]}`:"?"} found \u2014 the script needs bash 4+.`),!1)}return i("bash not found \u2014 the statusline runs as a bash script."),!1}function P(){console.log(r(`
+"use strict";var A=require("fs"),D=require("path");var j=require("os"),c=require("path"),J=(0,c.join)(__dirname,"..","tokenline.sh"),_=e=>e.global?(0,c.join)((0,j.homedir)(),".claude"):(0,c.resolve)(".claude"),$=e=>e.dir?(0,c.resolve)(e.dir,"tokenline.sh"):(0,c.join)(_(e),"tokenline.sh"),d=e=>(0,c.join)(_(e),"settings.json"),q=e=>e.includes(" ")?`bash "${e}"`:`bash ${e}`;var p=require("fs");function f(e){if(!(0,p.existsSync)(e))return{exists:!1,data:{}};let t=(0,p.readFileSync)(e,"utf8");if(t.trim()==="")return{exists:!0,data:{},raw:t};try{return{exists:!0,data:JSON.parse(t),raw:t}}catch{return{exists:!0,data:null,raw:t}}}function x(e){let t=`${e}.bak`;return(0,p.copyFileSync)(e,t),t}var S=e=>typeof e=="string"&&/tokenline\.sh/.test(e);var O=require("child_process"),I=require("os");var E=!!process.stdout.isTTY&&!process.env.NO_COLOR,h=(e,t)=>E?`\x1B[${e}m${t}\x1B[0m`:t,r=e=>h("1",e),W=e=>h("2",e),b=e=>h("32",e),G=e=>h("31",e),K=e=>h("33",e),m=e=>console.log(`${b("\u2713")} ${e}`),i=e=>console.log(`${K("!")} ${e}`),u=e=>console.error(`${G("\u2717")} ${e}`),s=e=>console.log(`${W("\u2192")} ${e}`);function w(){let e=(0,I.platform)();return e==="linux"||e==="darwin"?(m(`platform: ${e} (supported)`),!0):(i(`platform: ${e} \u2014 supported on Linux/WSL2 and macOS; the bash statusline likely won't render yet (see roadmap). Use --force to install anyway.`),!1)}function v(){let e=(0,O.spawnSync)("jq",["--version"],{encoding:"utf8"});return e.status===0?(m(String(e.stdout).trim()),!0):(i("jq not found \u2014 required at runtime. Install it (apt install jq / brew install jq)."),!1)}function C(){let e=(0,O.spawnSync)("bash",["--version"],{encoding:"utf8"});if(e.status===0){let t=String(e.stdout).match(/version (\d+)\.(\d+)/);return t&&Number(t[1])>=4?(m(`bash ${t[1]}.${t[2]}`),!0):(i(`bash ${t?`${t[1]}.${t[2]}`:"?"} found \u2014 the script needs bash 4+.`),!1)}return i("bash not found \u2014 the statusline runs as a bash script."),!1}function P(){console.log(r(`
 tokenline \u2014 environment check
-`)),w(),C(),v();let e=[{label:"project",global:!1},{label:"global",global:!0}];for(let t of e){let o=d({global:t.global,dir:null}),n=f(o);n.exists&&n.data&&S(n.data.statusLine?.command)?g(`${t.label} settings: tokenline configured (${o})`):n.exists&&n.data===null?i(`${t.label} settings: invalid JSON (${o})`):s(`${t.label} settings: not configured (${o})`)}console.log()}var a=require("fs"),L=require("path");function U(e){if(console.log(r(`
+`)),w(),C(),v();let e=[{label:"project",global:!1},{label:"global",global:!0}];for(let t of e){let o=d({global:t.global,dir:null}),n=f(o);n.exists&&n.data&&S(n.data.statusLine?.command)?m(`${t.label} settings: tokenline configured (${o})`):n.exists&&n.data===null?i(`${t.label} settings: invalid JSON (${o})`):s(`${t.label} settings: not configured (${o})`)}console.log()}var a=require("fs"),L=require("path");function U(e){if(console.log(r(`
 tokenline \u2014 installing the statusline
 `)),!w()&&!e.force){u("Unsupported platform. Re-run with --force to install anyway."),process.exitCode=1;return}C(),v();let o=$(e),n=d(e),k={type:"command",command:q(o),refreshInterval:1},l=f(n);if(l.exists&&l.data===null){u(`Could not parse ${n} (invalid JSON). Leaving it untouched.`),console.log(`
 Add this block manually, inside the top-level object:
@@ -13,10 +13,10 @@ ${JSON.stringify(k,null,2)}
 `);return}(0,a.mkdirSync)((0,L.dirname)(o),{recursive:!0}),(0,a.copyFileSync)(J,o),(0,a.chmodSync)(o,493),s(`wrote ${o}`);let N=l.data??{};l.exists?(x(n),s(`backed up ${n} \u2192 settings.json.bak`)):(0,a.mkdirSync)((0,L.dirname)(n),{recursive:!0}),N.statusLine=k,(0,a.writeFileSync)(n,JSON.stringify(N,null,2)+`
 `),s(`${R?"confirmed":T?"replaced":"added"} statusLine in ${n}`),console.log(`
 ${b("Done.")} Restart Claude Code to see the statusline.
-`)}var m=require("fs");function B(e){console.log(r(`
+`)}var g=require("fs");function B(e){console.log(r(`
 tokenline \u2014 uninstall
-`));let t=d(e),o=f(t);if(!o.exists||o.data===null?i(`No usable settings at ${t} \u2014 nothing to remove.`):S(o.data.statusLine?.command)?e.dryRun?s(`[dry-run] would remove statusLine from ${t}`):(x(t),delete o.data.statusLine,(0,m.writeFileSync)(t,JSON.stringify(o.data,null,2)+`
-`),s(`removed statusLine from ${t} (backup: settings.json.bak)`)):s(`No tokenline statusLine in ${t} \u2014 left untouched.`),e.purge){let n=$(e);(0,m.existsSync)(n)&&(e.dryRun?s(`[dry-run] would delete ${n}`):((0,m.unlinkSync)(n),s(`deleted ${n}`)))}console.log(`
+`));let t=d(e),o=f(t);if(!o.exists||o.data===null?i(`No usable settings at ${t} \u2014 nothing to remove.`):S(o.data.statusLine?.command)?e.dryRun?s(`[dry-run] would remove statusLine from ${t}`):(x(t),delete o.data.statusLine,(0,g.writeFileSync)(t,JSON.stringify(o.data,null,2)+`
+`),s(`removed statusLine from ${t} (backup: settings.json.bak)`)):s(`No tokenline statusLine in ${t} \u2014 left untouched.`),e.purge){let n=$(e);(0,g.existsSync)(n)&&(e.dryRun?s(`[dry-run] would delete ${n}`):((0,g.unlinkSync)(n),s(`deleted ${n}`)))}console.log(`
 ${b("Done.")} Restart Claude Code.
 `)}var Y=JSON.parse((0,A.readFileSync)((0,D.join)(__dirname,"..","package.json"),"utf8"));function z(e){let t={_:[],dir:null,global:!1,dryRun:!1,force:!1,purge:!1,help:!1,version:!1,unknown:[]};for(let o=0;o<e.length;o++){let n=e[o];switch(n){case"--dir":t.dir=e[++o]??null;break;case"--global":t.global=!0;break;case"--dry-run":t.dryRun=!0;break;case"--force":t.force=!0;break;case"--purge":t.purge=!0;break;case"-h":case"--help":t.help=!0;break;case"-v":case"--version":t.version=!0;break;default:n!==void 0&&n.startsWith("-")?t.unknown.push(n):n!==void 0&&t._.push(n)}}return t}function F(){console.log(`
 ${r("tokenline")} \u2014 a cache-aware statusline for AI coding CLIs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inbrace-tech/tokenline",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "A cache-aware statusline for AI coding CLIs — installs tokenline.sh and wires it into your Claude Code settings.",
   "bin": {
     "tokenline": "dist/cli.js"

package/tokenline.sh

@@ -9,9 +9,14 @@
 #
 # Repo:     https://github.com/inbrace-tech/tokenline
 # License:  MIT
-# Requires: bash 4+, jq, GNU coreutils (date -d, stat -c). Linux/WSL2 for v1.
+# Requires: bash 4+, jq. Linux/WSL2 or macOS (brew install bash jq).
 # ==============================================================================
 
+# Pin C locale: a comma-decimal locale (e.g. pt_BR) makes awk/printf emit
+# "46,2k" and reject dotted input. LC_ALL beats LC_NUMERIC, so set LC_ALL to
+# stay deterministic even when the user exports LC_ALL. Output is ASCII/bytes.
+export LC_ALL=C
+
 # --- Colors & Formatting Constants ---
 COLOR_GRAY=$'\033[38;5;244m'
 COLOR_DARK_GRAY=$'\033[38;5;240m'
@@ -34,6 +39,32 @@ if ! command -v jq >/dev/null 2>&1; then
   exit 0
 fi
 
+# --- GNU vs BSD coreutils (Linux vs macOS) ---
+# Probe behavior, not `uname`, so Homebrew coreutils is picked up automatically.
+if date -d "@0" >/dev/null 2>&1; then _date_gnu=1; else _date_gnu=0; fi
+if stat -c %Y . >/dev/null 2>&1; then _stat_gnu=1; else _stat_gnu=0; fi
+
+epoch_from_iso() {
+  # ISO-8601 -> epoch seconds; empty on failure (callers fall back to mtime).
+  local iso="$1"
+  if [ "$_date_gnu" -eq 1 ]; then
+    date -d "$iso" +%s 2>/dev/null
+  else
+    # BSD date needs an explicit format and rejects fractional secs / 'Z'.
+    # First 19 chars are always 'YYYY-MM-DDTHH:MM:SS'; transcripts are UTC.
+    date -u -j -f "%Y-%m-%dT%H:%M:%S" "${iso:0:19}" +%s 2>/dev/null
+  fi
+}
+
+file_mtime() {
+  local f="$1"
+  if [ "$_stat_gnu" -eq 1 ]; then
+    stat -c %Y "$f" 2>/dev/null
+  else
+    stat -f %m "$f" 2>/dev/null
+  fi
+}
+
 # --- Runtime state directory ---
 # Per-turn timestamp / TTL are cached between the 1s refreshes. Prefer a
 # per-user dir (0700) under XDG_RUNTIME_DIR: it avoids predictable, world-
@@ -176,10 +207,10 @@ compute_cache_timer() {
       | tail -n 1
     )
     if [ -n "$iso" ]; then
-      last_ts=$(date -d "$iso" +%s 2>/dev/null)
+      last_ts=$(epoch_from_iso "$iso")
     fi
     # Mtime fallback if parsing is unsuccessful
-    [ -z "$last_ts" ] && last_ts=$(stat -c %Y "$transcript_path" 2>/dev/null)
+    [ -z "$last_ts" ] && last_ts=$(file_mtime "$transcript_path")
   fi
 
   # Fallback to local session caching file if transcript read is unavailable or cached timestamp is newer