Skip to content

Releases

Clepso 0.4.0 alpha 2 — Recorded activity (alpha)

Choose a tag to compare

@obileonardo obileonardo released this 23 Oct 23:42

Clepso 0.4.0 alpha 2 — recorded activity

Gemini CLI users can enable Read recorded token activity in Settings. Limits shows numeric activity from the newest 16 retained recordings on this Mac. Cache is part of input and is not counted twice. Repeated message records/checkpoints are deduplicated; malformed, oversized and additional coverage stays explicitly partial.

The reader is optional, local and bounded. Recording files also contain conversations; Clepso discards content and does not read credentials or enable telemetry. Numeric activity, hashed deduplication keys and a temporary file cache stay in memory. Disabling clears the cache. This does not establish subscription quota percentages or reset times; those remain unknown. No new provider counts are uploaded or shared through widgets/MCP.

The existing widgets, MCP server, signed updater, Goals fixes, native characters and Claude/Codex tracking remain available. The brand pipeline's Pillow dependency was updated to 13.0.0; a full rebuild and font checks passed, with identical pixels across 181 PNGs. The tooling dependency is not bundled in the Mac app.

Other provider adapters, mobile/Watch/relay/push, extra model editions and physical QA continue separately. Social sign-in and domain purchase remain on hold. No new sign-in emails or model prompts were sent.

Clepso 0.4.0 alpha 1 — Within reach (alpha)

Choose a tag to compare

@obileonardo obileonardo released this 22 Oct 08:51

Clepso 0.4.0 alpha 1 — within reach

This alpha adds desktop widgets, a read-only MCP server and signed in-app updates. Existing Claude/Codex readers,
menu-bar rotation, Goals controls, stepped toggles, compact Account layout and native model characters remain available.

  • Widgets: small and medium WidgetKit layouts. Enable sharing in Settings → Integrations, then add Clepso limits
    from the Mac widget gallery. Missing, manual, old and expected-reset readings stay explicitly labeled.
  • MCP: allow a named client in Settings → Integrations, review its disclosure and copy the setup. Two read-only
    tools expose limits and reader health; no prompts, paths, credentials, session IDs or shell access. Revoke access
    without restarting a client. Your client may forward usage readings to its AI provider.
  • Updates: Sparkle 2.10.0 with signed feeds and archives, verification before extraction and no system-profile
    reporting. Manual check, daily checks and automatic installation are in Settings. Automatic choices start off.
    Earlier updater-free releases still need this first upgrade by DMG/Homebrew.
  • Models: a restrained native pixel flourish marks a newly reached output level while viewing the same model.
    Opening a model, changing range, demo mode, replayed older readings and inactive views do not trigger it.
    Pause and Reduce Motion stop the moving effect.
  • Publisher: privacy contact is Elvis Obi, Lagos, Nigeria, contact@elvisobi.com. No new domain was purchased.

Sharing is optional and local. The widget is a separate sandboxed extension, using only an allowlisted aggregate
snapshot. MCP uses a private file and local stdio, with no HTTP listener. Deleting local data revokes sharing and
clears the widget snapshot. No existing tracking connection is disabled by this update.

This is an incremental alpha, not a claim that every roadmap item is live. Automatic adapters for the other
providers, iPhone/Watch/relay/push, live Apple/Google/GitHub OAuth, additional edition costumes and remaining physical
QA continue separately. The publisher confirmed that OAuth applications have not yet been registered. Domain
purchase remains explicitly excluded. A legal engineering review is not an external legal sign-off.

Computer use still fails to attach, so fresh widget-gallery, VoiceOver and physical focus/lifecycle checks remain
unverified. The committed QA report records automated and build/signing evidence separately.

Clepso 0.3.0 alpha 3 — The literary guild comes home

Choose a tag to compare

@obileonardo obileonardo released this 22 Oct 02:34

Clepso 0.3.0 alpha 3

The literary guild now lives in the Mac app.

  • New original pixel characters in the Models portrait, roster and level track: the Opus owl maestro, Fable fox storyteller, Sonnet verse keeper and Haiku paper crane.
  • Opus 5/5.5 and Fable 5/5.1 have different silhouettes, costumes and books. Other versions keep the base family art; unknown families get a neutral robot.
  • Authored gestures and blinks replace the whole-body bob. Only the selected portrait animates. Pause/Resume, system Reduce Motion and hidden/inactive-view suspension keep the screen quiet.
  • About explains the names and edition details. Artwork is original Clepso interpretation, not an official provider mascot or a capability claim; levels still come from all-time output tokens.
  • The website reflects the shipped artwork and preserves the original art for comparison. Its level-up flourish remains a website demo.

The stepped toggle thumb, compact Account upload layout, Goals +/- correction, desktop/IDE integration, Codex reading, Calendar export and optional email accounts remain included. Existing preferences and consent are retained.

Apple silicon, macOS 14 or later. The app and DMG are signed and notarized. Upgrade using the DMG or Homebrew;
automatic in-app updates are not enabled in this alpha.

For the complete implemented/future/verification inventory, see implementation status.

Verification: 544 tests in 108 suites and all 17 strict local gates passed. App and DMG are signed, notarized and stapled. Full VoiceOver, physical focus traversal, older/clean macOS and long-sleep/restart notification QA remain follow-ups; see the linked implementation inventory.

Clepso 0.3.0 alpha 2 — Small details. Better fit.

Choose a tag to compare

@obileonardo obileonardo released this 21 Oct 20:26

Clepso 0.3.0 alpha 2

A small interface update for the Mac app, accompanied by a refreshed website.

  • Toggle thumbs now follow the track’s stepped pixel corners in both On and Off states.
  • Account uploads use a compact status/action layout. The full privacy explanation remains available under “What gets uploaded?”
  • Connected accounts show connection wording rather than asking you to sign in again.
  • The website has a clearer product landing page and a new interactive character-art preview. The preview’s new characters are not in this Mac binary yet.

The existing Claude desktop/IDE connection, Codex reading, Calendar export and optional email accounts remain available.
This update does not install new agent integrations or change your existing consent choices.

Install

Apple silicon Mac, macOS 14 or later. Quit Clepso, replace the existing app using the signed, notarized DMG, then reopen it.
Existing settings and usage history are retained. Homebrew users can upgrade the named Clepso cask after the tap update.

This is an alpha. Automatic updates are not enabled. Full VoiceOver, older/clean macOS, and long-sleep/restart notification
behavior remain additional QA work. The shipped desktop/IDE bridge depends on the provider continuing to expose its reviewed usage fields.

Clepso 0.3.0 alpha 1 — Claude, everywhere

Choose a tag to compare

@obileonardo obileonardo released this 21 Oct 16:28

Clepso 0.3.0 alpha 1 — Claude, everywhere

This update includes the tested desktop/IDE connection, weekly Calendar export and clearer Goals controls in the
installed app. Apple silicon, macOS 14 or later. This remains alpha software.

Included

  • Claude desktop and VS Code limits. Settings → Claude Code → Desktop app and VS Code panel is now
    available. Its consent sheet installs Clepso's small, reversible Claude Code mod. It reports five-hour and weekly
    usage, reset times, context usage and model identity after replies in the desktop Code tab and the graphical
    VS Code panel. Terminal tracking continues through the existing status line. Readings share the same limits;
    they are not added together. A fresh terminal source has priority for 60 seconds.
  • Clear Goals buttons. Dedicated pixel plus/minus icons replace font characters, with a centered, balanced cross.
    Right-aligned controls, target toggles, value bounds and accessible button names are preserved.
  • Add reset to Calendar. A reported weekly reset on Limits can open a one-time Calendar event. Calendar asks
    before adding it. A reset is an expected time reported by the provider and can change; an imported event does
    not update automatically. Five-hour resets are excluded.
  • Optional email accounts. The official build includes the existing accounts project and branded Protocol
    sign-in emails. Sign in explicitly from Account to sync daily activity summaries to Clepso's hosted web dashboard.
    Sign-in uses a one-time link and PKCE; open it on the Mac that requested it. Apple/Google/GitHub console setup
    remains separate and those providers are not enabled. Local tracking works without signing in.
  • What's new. Existing users upgrading from v0.2 see a card linking to the new connection, Calendar and Goals.
    The rotating Claude/Codex menu-bar limits, earlier alignment/color/type improvements, manual snapshots and
    retention/reset-reminder fixes remain included.

Privacy and verification

The mod hands only allowlisted usage/model/session fields to the fixed local helper; session identifiers are HMAC
references before socket delivery. It reads no prompts, replies, transcripts, code, credentials or project paths.
The mod's data path stays on the Mac. Optional signed-in accounts upload the documented daily aggregates, never
those raw frames; see privacy and security.

Live checks on this Mac verified desktop Code 2.1.304 and VS Code extension 2.1.305: real quota/reset frames,
normal mapper/store adoption, native usage agreement, desktop/IDE model-id agreement and matching hook tasks.
Removal and restoration were verified at the settings/files level. Native plugin-removal UI could not be checked
after macOS capture errors. Older/clean macOS, full VoiceOver and long sleep/restart verification remain incomplete.
See the desktop and IDE records for their exact scope.

Desktop/IDE installation remains explicit opt-in for every user. It starts with a new Claude session; an
organisation that disables mods cannot supply those readings. This supports Claude Code surfaces, not general
Claude Chat conversations. Missing or stale readings retain their stated condition.

No automatic updater is included. Quit Clepso, replace the app with this DMG's copy, then reopen it; the Homebrew
tap also tracks this release. Existing history and preferences are preserved. A signed, notarized and stapled app
and DMG plus SHA256SUMS accompany the release.

Clepso 0.2.0 alpha 5 — Goals controls

Choose a tag to compare

@obileonardo obileonardo released this 20 Oct 15:45

Clepso 0.2.0 alpha 5: Goals controls

Goals now use Clepso's existing pixel minus/plus buttons instead of native up/down chevrons. Each target card keeps
the Target label and value on the left, with the On/Off toggle and adjustment buttons aligned to the right.
Active-day targets still range from 1–7 in single-day steps; percentage targets range from 10–100 in five-point
steps. Buttons disable at the bounds. Turning a target off hides its adjusters, and turning it on restores its
default. Each adjustment button has a descriptive accessibility label and uses the existing pixel focus style.

Native QA verified all three target ranges, saved changes and toggle behavior, plus the layout in dark and light
appearances. Existing usage history, goals, menu-bar preferences and source connections are preserved.

Release packaging now checks free space on the actual build volume and separately on the temporary volume,
so builds stored on an external drive use the correct storage requirements.

Download Clepso-0.2.0-alpha.5.dmg below. Requires macOS 14+ on Apple silicon. The app and disk image are Developer
ID signed, Apple notarized and stapled. Quit Clepso before replacing the installed app, then reopen it.
SHA256SUMS contains the disk-image checksum. Public Stage A feature gates remain in effect.

Homebrew

Install the same notarized alpha with:

brew install --cask obileonardo/clepso/clepso

Apple silicon, macOS 14 or later. See the official tap for existing-DMG migration, upgrade and uninstall instructions.

Clepso 0.2.0 alpha 4 — Colored menu pill

Choose a tag to compare

@obileonardo obileonardo released this 20 Oct 15:01

Clepso 0.2.0 alpha 4: A colored, compact menu pill

The menu pill now uses Clepso's theme accent, uppercase labels and the bundled Clepso Pixel display face.
Horizontal content padding is 6 points per side, reduced by 2 layout pixels from the former 8-point inset.
The icon and text stay centered as the Claude/Codex 5-hour and 7-day readings rotate. Approaching limits use
amber, reached limits coral, and old/missing readings keep their explicit wording and state glyphs.

Editing a manual reading now shows an update heading. Native QA covers keyboard focus, Tab/Shift-Tab,
Space/Return/Escape, Calendar-grid arrows, manual form validation/save/edit/provider-plan clearing, and importing
a synthetic weekly reset into macOS Calendar. Test data is removed afterward. Calendar actions remain hidden
in this public Stage A build. Accounts, automatic updates and the optional desktop/IDE mod remain off.

Download Clepso-0.2.0-alpha.4.dmg below. Requires macOS 14+ on Apple silicon. The app and DMG are Developer ID
signed, Apple notarized and stapled. Quit Clepso before replacing your installed copy, then reopen it.
Usage history and preferences are preserved. SHA256SUMS contains the disk-image checksum.

Intel builds and a separate clean macOS user-account test remain outstanding. This is an alpha release.

Validation: 539 tests across 107 suites, all 16 local contributor gates, both
hosted CI jobs, and all four languages in the
release-source CodeQL scan passed. No open CodeQL findings.

Clepso 0.2.0 alpha 3 — Centered menu bar

Choose a tag to compare

@obileonardo obileonardo released this 20 Oct 13:35

Clepso 0.2.0 alpha 3: Centered menu bar readouts

The dynamic menu bar's icon and text are now centered together inside the pill. Alpha 2 reserved room for the
longest reading but left all unused space on the right, making shorter frames look off-center. The corrected
drawing distributes that space on both sides, on whole pixels, while preserving the same width across rotation.

All alpha 2 features remain: Claude Code and Codex
5-hour/7-day readouts, pinned modes, explicit stale/reset states and accessibility pause controls. Settings and
usage history are preserved. This build keeps accounts, automatic updates and the optional desktop/IDE mod off.

Download Clepso-0.2.0-alpha.3.dmg below. Requires macOS 14+ on Apple silicon. Quit Clepso, open the DMG, replace
your installed app, then reopen it. The app and DMG are Developer ID signed, Apple notarized and stapled.
SHA256SUMS contains the disk-image checksum. The alpha 2 platform/verification limitations still apply.

Clepso 0.2.0 alpha 2 — Dynamic menu bar

Choose a tag to compare

@obileonardo obileonardo released this 20 Oct 10:04

Clepso 0.2.0 alpha 2: Dynamic menu bar

See which agent and window a limit belongs to without opening the panel. The menu bar now rotates through
Claude Code 5-hour, Claude Code 7-day, Codex 5-hour and Codex 7-day readings every six seconds. Each frame shows
the agent, window and percentage used, with that window's existing Clepso pixel status glyph.

  • Most pressing windows lead the rotation; every configured window still gets a turn.
  • Settings → General → Menu bar readout lets you pin any one window or keep the previous aggregate summary.
    Switch off Show usage in menu bar for the icon alone. Choices survive restarting the app.
  • Old readings explicitly say OLD. A passed reset says RESET?, awaiting fresh evidence; elapsed time never
    invents availability. Missing readings say N/A or WAIT, and a pinned disabled agent says OFF.
  • The readout reserves a consistent width so neighbouring menu bar items stay in place. Rotation pauses on hover,
    with Reduce Motion and with VoiceOver. The accessible label/help include all four windows and their freshness.
  • Codex reading remains opt-in under Settings → Codex. Automatic readings still come from Claude Code's status
    line and Codex's local session files; manually entered allowances stay separate.

Install or update

Requires macOS 14+ on Apple silicon. Quit Clepso, download Clepso-0.2.0-alpha.2.dmg from Assets below, open it,
and drag Clepso into Applications, replacing the previous copy. Launch the new copy from Applications.
Your history, connections, goals and preferences are preserved. There are no automatic updates.

The app and DMG are Developer ID signed, notarized by Apple and stapled. SHA256SUMS contains the disk-image hash;
with both downloaded files in one folder, run shasum -a 256 -c SHA256SUMS to verify it.

Alpha scope

Everything from alpha 1 remains included.
This is still an alpha build. Accounts, automatic updates and the optional Claude Code desktop/IDE mod remain off
in this public build. It makes no network requests and does not transmit prompts, replies or project paths.
Intel Macs are unsupported. macOS 14/15 and a first launch under a separate clean macOS user account remain
unverified, as does the complete native keyboard/form/Calendar-import flow. See the
readout specification for state semantics.

Clepso 0.2.0 alpha 1 — Your first season

Choose a tag to compare

@obileonardo obileonardo released this 20 Oct 08:06

Clepso 0.2.0 alpha 1: "Your first season"

Your coding-agent limits, before you hit them. Clepso is a menu bar app for macOS that shows how much of your
Claude Code and Codex usage limits you have used, when they reset and how fast you are going, from what those agents
report on your own Mac.

This release opens two pages that were waiting for some history. Clepso 0.1 kept collecting what they need, so if you
ran 0.1 they open with your own numbers, not from zero.

What's new

  • Other agents, by hand (Dashboard › Limits): dated readings for Claude Chat, ChatGPT, Gemini, Grok, Cursor,
    GitHub Copilot and Windsurf. Every card says "Entered by you", keeps its measurement time and selected plan,
    and marks a passed reset as expected. These readings stay separate from automatic telemetry and do not trigger
    automatic alerts. Paid overage appears only when you explicitly confirm enabling it.

  • Choose shorter retention in Settings › Your data. Defaults remain 90 days for limits, 30 for sessions and
    notification receipts, and 7 for diagnostics. Shortening a period applies immediately. Export includes the selected
    periods, manual readings and reset schedules.

  • Scheduled reset tracking. Reset notices retain their source and status across launches. An actually delivered
    reminder can qualify a later Ready again alert; a timer alone never does. Expected-reset notices retain their 15-minute
    freshness limit on app wake; obsolete reminders are cancelled after confirmed recovery.

  • Backup expiry. Unchanged settings backups expire 30 days after disconnect and are cleaned if Clepso opens
    again with no active connection. Edited or unrelated files are preserved; Delete all still offers immediate removal.

  • Player Card (Dashboard › Card): your Claude Code "player card": total tokens, level, streaks, sessions, active
    days and top model on the front, recent activity on the back. Save it as a PNG, copy it or share it. It is built on
    your Mac from Claude Code's statistics file (opt-in, as in 0.1) and Clepso's own readings; nothing is sent unless you
    share it yourself.

  • Goals (Dashboard › Goals): targets you set for active days a week, your 5-hour peak and where the 7-day limit
    finishes the week, each with its own streak. Home's "Today" list now flags a goal that is at risk or missed.

  • "What's new" on Home. After an update, Home shows one card about what changed, once. It is written into the app
    (Clepso still makes no network requests), you can dismiss it, and its changelog link opens your browser only if you
    click it. A new install doesn't show it: the welcome window comes first.

  • The Home level bar's Open card button is back.

Everything from 0.1 is unchanged: limits in the menu bar and the panel, Codex beside Claude Code (opt-in), alerts,
quiet hours, reset reminders, the Dashboard, themes, export and Delete all. The full list is in the
0.1.0-alpha.1 notes.

Install

  1. Download Clepso-0.2.0-alpha.1.dmg below. It needs macOS 14 or later on a Mac with Apple silicon (M1 or newer).
    Optionally, check it: shasum -a 256 -c SHA256SUMS in the folder holding both files should print OK.
  2. Open the disk image and drag Clepso into Applications. Install it there before the first launch: Open at
    login only works from Applications. Updating from 0.1: quit Clepso first (Quit in the panel), then replace the
    old copy. Your history, goals, settings and Claude Code connection stay as they are, and steps 4 and 5 don't come
    up again.
  3. Open Clepso from Applications. It is signed with a Developer ID and notarised by Apple, so macOS opens it after the
    usual "downloaded from the internet" question.
  4. Follow the welcome window. To read Claude Code's limits, Clepso asks to connect to Claude Code. It shows you the one
    setting it changes, statusLine.command in ~/.claude/settings.json, and keeps a byte-exact backup first.
  5. On the last step, switch on Open at login if you want Clepso to start with your Mac (off unless you choose it;
    you can change it later in Settings). Then eject the disk image.

Limits appear after Claude Code's next reply in a terminal: Claude Code sends them each time it runs.

Private by design

  • No network in this build. This build has no accounts, so Clepso never signs in, uploads or checks for updates.
    Everything stays on your Mac.
  • Allowlist, not blocklist. The helper that Claude Code runs copies only named fields (limits, model, token and
    cache counts, durations, line counts, the cost estimate). It never forwards your prompts, replies, file paths,
    transcript or project names, and it cannot reach the network.
  • Reversible. Connecting changes one key in your Claude Code settings after a backup; removing restores the
    original bytes. If you already had a status line, it keeps working.
  • Yours to take or delete. Settings › Your data has Export (a JSON file of everything stored) and Delete.

The full design is in docs/PRIVACY_AND_SECURITY.md.

What "alpha" means here

  • No automatic updates. Clepso does not check for new versions (that would be network traffic). Use GitHub's
    Watch › Custom › Releases on this repository to hear about the next one, then install it the same way, over the
    old copy.
  • Apple silicon only. The app is built for Apple silicon. The small helper Claude Code runs is universal, so it
    also works when Claude Code runs under Rosetta.
  • Not yet verified: Intel Macs (not supported), macOS 14 and 15 (built for 14, used daily on newer macOS), a
    first launch on a separate clean macOS user account, and a complete native keyboard/form/Calendar-import run for
    the new controls. The signed debug build was launched with an isolated test home; this is not a separate OS account.
  • Upstream formats can change. Claude Code's status line is documented, but Codex's session files are not. If an
    agent changes what it writes, Clepso shows its numbers as missing or stale, never as 0%. A fix will follow as a
    patch release.

Known limitations

  • Limits come from Claude Code's status line, which runs in a terminal (including an IDE's built-in terminal, such
    as VS Code's or JetBrains'). The Claude desktop app's Code tab and the VS Code graphical panel don't run the
    status line. Usage there still counts against your plan (and, with agents per task on, the desktop app's tasks are
    counted), but the limit figures update only when a terminal session next reports.
  • Claude Code's status line reports the 5-hour and 7-day limits only. Others, such as a weekly limit for one model,
    appear in /usage in Claude Code.
  • Automatic readings cover Claude Code and Codex. Other supported providers use dated manual entry; automatic
    adapters for them remain planned.
  • Cost figures are Claude Code's own estimate at list price, not your bill.

Uninstall cleanly

  1. In Clepso, open Settings (⌘,). Under Your data, choose Delete…, keep everything ticked, and confirm
    with Delete All. This removes Clepso's database, diagnostics log and notifications, switches off Open at login,
    and takes Clepso out of Claude Code, restoring your settings from the backup. Tick "Also delete settings backups" if
    you don't want to keep them.
    • To only disconnect from Claude Code and keep your history, use Remove from Claude Code… in Settings instead.
  2. Quit Clepso (Quit in the panel) and drag Clepso from Applications to the Trash.

If the app is already gone, your Claude Code status line keeps working: Clepso's wrapper falls back to your original
command when the app is missing.

Checksums and signature

SHA256SUMS lists the disk image's SHA-256. The app and the disk image are signed with
"Developer ID Application: Obi Elvis (DD8UY75RZT)", use the hardened runtime, carry no sandbox or other exception
entitlements, and are notarised and stapled. To check: spctl -a -vvv -t exec /Applications/Clepso.app should print
accepted and source=Notarized Developer ID.

Clepso is open source under the MIT licence. The licences of the software it includes ship inside the app
(Clepso.app/Contents/Resources/LICENSE and Acknowledgements.txt).