Skip to content

tsouth89/ceiling

 
 

Repository files navigation

Ceiling

AI usage. One elegant view.ceiling.win

Ceiling is a focused, local-first Windows companion for the AI subscriptions you actually use. It keeps rolling limits, reset times, and stale/error states visible from the system tray or a lightweight capacity strip above the taskbar.

The goal is not another giant provider dashboard. It is a fast, calm way to answer one question: how much AI capacity do I have left, and when does it reset?

Ceiling's overview showing Codex, Claude, and Cursor usage at a glance

Initial focus

  • OpenAI Codex
  • Claude
  • Cursor
  • Gemini / Google AI
  • GitHub Copilot

Additional providers remain available from the underlying foundation while Ceiling is narrowed around reliable support for the core five.

What Ceiling feels like

  • Taskbar-adjacent capacity strip: Windows 11 does not support old-style third-party taskbar toolbars, so Ceiling uses a transparent, always-on-top strip that sits just above the taskbar without stealing focus.
  • Tray at a glance: a compact flyout with each provider's remaining capacity, reset time, source, and freshness.
  • Truthful state: a visible distinction between live, cached, stale, and failed reads. No fake precision when a provider cannot report a limit cleanly.
  • Local first: credentials and usage data stay on the machine. Browser cookies, API keys, and login sources remain opt-in.
  • Windows-native: Tauri, React, and Rust; fast startup, low idle work, and system accent-aware appearance.

Ceiling's tray flyout with each provider's remaining capacity and reset time

Download

Ceiling runs on Windows 10 and 11.

Download for Windows →  ·  ceiling.win  ·  all releases

The installer and portable build are code-signed. Ceiling is local-first: it reads usage from sources on your PC or from each provider's own usage endpoint, and never sends your credentials or usage data to Ceiling-operated servers. See How Ceiling gets your data for the per-provider detail.

Development

git clone https://github.com/tsouth89/ceiling.git
cd ceiling
pnpm --dir apps/desktop-tauri install --frozen-lockfile
pnpm --dir apps/desktop-tauri tauri:dev

The active desktop app lives in apps/desktop-tauri. Shared provider and usage logic lives in rust.

For the active implementation state and the next work items, see docs/HANDOFF.md. For the tray and strip visual system, see docs/CEILING_UI.md. Maintainers should follow the release checklist for public builds.

Lineage, license, and credits

Ceiling is an independent Windows-focused fork of Win-CodexBar, which is itself based on Peter Steinberger's CodexBar. Ceiling is not affiliated with or endorsed by either upstream project.

The project is released under the MIT license. The original copyright and license notice are retained as required by that license.

About

A focused Windows AI capacity monitor for Codex, Claude, Cursor, Gemini, and Copilot.

Topics

Resources

License

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 71.4%
  • TypeScript 19.3%
  • CSS 5.8%
  • PowerShell 1.3%
  • JavaScript 0.8%
  • Fluent 0.7%
  • Other 0.7%