Skip to content
CLEPSOdocs

Docs / Privacy

Privacy

Clepso works fully on your Mac without an account. If you choose to sign in, it uploads daily counts so you can see your goals and usage elsewhere. Published by Elvis Obi, Lagos, Nigeria. Updated 22 October 2026.

On this page

Publisher and contact

Clepso is published by Elvis Obi, Lagos, Nigeria. For privacy questions, corrections or requests, email contact@elvisobi.com. Clepso is independent software and is not affiliated with the AI providers whose usage it displays.

On your Mac

Clepso reads Claude Code's status line (limits, model, context, session cost estimate, durations, lines changed), and, only if you turn them on, Claude Code's statistics file, four background hooks that count subagents per task, and Codex's session files (only the token count and model lines: limits, plan and tokens per day; prompts and replies in them are skipped unread). A helper drops everything else (prompts, replies, file paths, project names) before anything reaches the app. Readings stay in a local database for 90 days (sessions and tasks 30). Delete all removes everything Clepso stored and restores Claude Code's settings.

If you sign in: what is uploaded

Once an hour, the last 14 days, to a database in Frankfurt (Supabase, EU), readable only with your sign-in:

DataFieldsOnly when
ProfileName you typed, plan name you choseAlways
Daily activityDay, messages, sessions, active or notClaude Code stats are on
Tokens per model per dayDay, model name, token countClaude Code stats are on
Totals per modelModel name; input, output, cache read and cache write tokensClaude Code stats are on
Limits per dayDay, the 5-hour limit's peak %, the 7-day limit's % at the end of the dayAlways
Agents per dayDay, tasks, subagents, subagents by built-in type (custom agents as "custom")Counting agents is on
GoalsGoal kind and target; each day's value and whether it was metAlways

Never uploaded: prompts, replies, file or folder paths, project or repository names, transcript locations, session or agent ids, per-session cost, your Claude account details or anything about other apps.

Your account

Sign-in is by email link (Apple, Google and GitHub to follow). Your email is held by the sign-in service to send links; it is not stored with your counts. Delete account (Clepso › Account) deletes the account and every row stored with it, at once. Signing out stops uploads; deleting the account removes what was uploaded. Clepso does not sell personal data or use advertising trackers.

Optional local integrations

Desktop widgets and MCP sharing start off. Widgets receive only provider/window names, reported percentages, observation and reset times, source and state in an app-group container. MCP exposes the same allowlisted fields to clients you explicitly allow in Settings. Your MCP client may forward readings to its AI service. Revoke a client in Settings; deleting local data revokes all grants. Local processes running under your Mac account can read this shared snapshot. Neither integration receives prompts, replies, paths, session identifiers, email addresses or credentials.

When enabled, automatic updates contact the Clepso update feed hosted on Vercel and download releases from GitHub. Update archives and feeds are signed. Automatic checks and downloads are choices in Settings; no system profile is sent.

Optional Gemini CLI recording reader

From 0.4.0 alpha 2, a separate opt-in reader scans the newest Gemini CLI recordings for numeric activity and timestamps. These files also contain conversations; content is discarded. Numeric activity, hashed deduplication keys and a temporary file cache stay in memory on this Mac. Paths are used to find files and cache modification times, and are never persisted or uploaded. Disabling clears the cache. Credentials are not read and provider telemetry is not enabled. These counts are not included in account uploads, widgets or MCP snapshots. They do not establish your subscription allowance.

Service providers

The public website is hosted on Vercel; downloads are hosted on GitHub. Optional accounts use Supabase for authentication and storage and Namecheap Private Email for sign-in delivery. These services process the requests needed to provide those features, including normal connection metadata such as IP addresses. Reading usage locally does not require a Clepso account. Provider account subscriptions remain with their respective providers.

Your controls

Choose retention in Settings. Export or delete local data there, turn off individual readers and sharing, or delete your Clepso account from Account. Account deletion removes the server rows belonging to your account; uninstalling the app by itself does not request server deletion. Contact the publisher if you need help with a privacy request.

Security

Every table is protected by row-level security: a signed-in user can read and write only their own rows, and an anonymous request is refused. The app holds only the project's publishable key; your session is kept in this Mac's Keychain.