Skip to content

v1.0.1 — Clepsydre

Choose a tag to compare

@tpierrain tpierrain released this 03 Jul 06:03

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.md gauge — see context rot coming and /clear at 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

  • resolveMax ignores a non-numeric / zero / negative window value and always floors to a sane denominator (no more /NaN or a stuck 0% gauge).
  • readMemory counts only regular files — a subdirectory or a dangling symlink named *.md no longer inflates the memory segment.
  • Internal cleanups: a single shared tier helper, one statSync per file, one git spawn on the hot path.
  • .gitattributes pins 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
plain git 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.