v1.0.1 — Clepsydre
Clepsydre — an always-on context-window status line for Claude Code.
First published release. It ships the cross-platform Node port (macOS + Windows,
no jq/bc/bash), configurable color thresholds, and a code-review hardening pass.
Highlights
- 🧠/
⚠️ /🤪 token gauge and 🧩/⚠️ /🧨MEMORY.mdgauge — see context rot coming and/clearat the right time. - Cross-platform: pure Node, one artifact for macOS and Windows.
- Configurable thresholds via
CLEPSYDRE_*env vars (global or per-project).
Hardening in this release
resolveMaxignores a non-numeric / zero / negative window value and always floors to a sane denominator (no more/NaNor a stuck0%gauge).readMemorycounts only regular files — a subdirectory or a dangling symlink named*.mdno longer inflates the memory segment.- Internal cleanups: a single shared tier helper, one
statSyncper file, onegitspawn on the hot path. .gitattributespins LF so Windows clones never get CRLF.
Install
Just ask Claude Code to install Clepsydre for you (see the README), or do it by hand:
git clone git@github.com:tpierrain/clepsydre.git ~/clepsydre
cd ~/clepsydre && node install.mjs
Then restart Claude Code.
⚠️ Ignore the "Source code (zip / tar.gz)" archives below. They are attached
automatically by GitHub and are useless for Clepsydre. The installer points your
status line at an absolute path inside your cloned repo, so updates land with a
plaingit pull— no re-install. A downloaded archive has no git history to pull
from, so it can never update itself. Clone the repo; don't download the zip.