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:
| Data | Fields | Only when |
|---|---|---|
| Profile | Name you typed, plan name you chose | Always |
| Daily activity | Day, messages, sessions, active or not | Claude Code stats are on |
| Tokens per model per day | Day, model name, token count | Claude Code stats are on |
| Totals per model | Model name; input, output, cache read and cache write tokens | Claude Code stats are on |
| Limits per day | Day, the 5-hour limit's peak %, the 7-day limit's % at the end of the day | Always |
| Agents per day | Day, tasks, subagents, subagents by built-in type (custom agents as "custom") | Counting agents is on |
| Goals | Goal kind and target; each day's value and whether it was met | Always |
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.