mrkeyoor.com_
Wed 30 Sept 06:09 UTC
Dev Toolsevaluationupdated 30 Sept 2026

codenotch review

Codenotch pins a small usage display to the edge of your desktop, showing quota windows and activity for Claude Code, Codex, Cursor, and other coding tools. The main app is native Swift for macOS, while a Rust and Tauri port covers Windows and an incomplete Linux path.

Verdict

Our Windows-tree check resolved 486 packages, then both the 190-second build and 20-second test run failed during compilation, so Codenotch is easier to recommend as a packaged macOS app than as source you build everywhere. Its edge display and honest stale-data states solve a real annoyance for developers juggling several plans. Use it only if you accept that local credential formats and private usage endpoints will keep breaking, and test the exact providers you pay for after every update.

We ran it

Lab card: what happened when we ran codenotch
Install✓ · 22s486 packages
Build✗ · 190s
Tests✗ · 20sran, no count parsed
Repo489 files~122,354 lines of source · 32.3 MB · 4 CI workflows

Answers from our run

Does codenotch build from source?

Dependencies installed in 22 seconds (486 packages), and the build failed. We cloned commit 0083369 into a clean Debian container with 3 CPUs and no project-specific setup.

Do codenotch's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use codenotch?

Security policies that forbid reading local CLI sessions, keychains, credential files, or editor databases, even read-only.

What are the alternatives to codenotch?

CodexBar, Claude Code, Codex. Our Windows-tree check resolved 486 packages, then both the 190-second build and 20-second test run failed during compilation, so Codenotch is easier to recommend as a packaged macOS app than as source you build everywhere.

Setup2/5Packaged apps are simple; our Rust build and tests did not compile
Docs5/5Provider sources, limits, builds, fallbacks, and privacy are explicit
Community4/52,613 stars with active issues, pull requests, and daily releases
Maturity3/5Polished macOS app; Windows and Linux paths are still catching up

Who it’s for

Developers paying for several coding assistants who want quota windows visible without opening each tool.
macOS users who want session-finished and waiting-for-input alerts beside usage readings.
Windows users willing to run an unsigned installer and accept a newer port with fewer providers.
Contributors interested in provider adapters built around local sessions, caches, databases, and vendor endpoints.

Who it’s NOT for

Security policies that forbid reading local CLI sessions, keychains, credential files, or editor databases, even read-only.
Anyone who needs a vendor-supported usage API: the README says providers expose no clean universal percentage API and their private response shapes can change.
Windows users unwilling to bypass a SmartScreen warning: the installer is not code-signed.
Linux users who need full feature parity: dragging, terminal focus, Antigravity credentials, and installed-app icons are listed as unavailable.
Teams requiring a green Debian source check: both our build and tests failed during Rust compilation.

Setup reality

Our sandbox installed the windows/ Rust project at commit 0083369 in 22 seconds, resolving 486 packages. The build failed with exit 101 after 190 seconds, and tests failed with exit 101 after 20 seconds. Both stopped at compilation; the excerpt says one earlier error caused the failure but does not include that error.

The signed and notarized macOS DMG is the easier route and needs macOS 15 or later. Building it needs Xcode, XcodeGen, and create-dmg. Windows source builds need Rust's MSVC toolchain and WebView2; the packaged installer can fetch WebView2.

Runtime access comes from sessions and files already created by the monitored tools. Some providers instead require a pasted key or an explicit in-app browser sign-in. The unsigned Windows installer triggers SmartScreen, while Linux needs GTK, WebKit, AppIndicator, X11 or XWayland, and several system development packages.

Codenotch puts quota windows where you can see them

Codenotch draws a small pill on a screen edge and fills it with rings for coding-assistant usage. Hovering reveals the limit windows and reset times. The app can also tell when a session is working, finished, or waiting for input, then open briefly and play a sound. This is a focused answer to a familiar problem: subscription limits live in separate tools and often become visible only after work has stopped.

The provider list is broader than the name suggests. The macOS app reads Claude Code, Cursor, Codex, DeepSeek, Antigravity, local Ollama and LM Studio, plus several other services. The Windows port currently covers a smaller group. Multiple Claude and Codex profiles become separate rings when their directories follow the documented naming convention. In each case, Codenotch tries to reuse a session the original tool already owns rather than making you create another login.

Usage readings depend on interfaces vendors may change

The README is unusually direct about data quality. No supported vendor interface gives every tool a simple, stable percentage-used value. Codenotch therefore reads a mix of official endpoints, local SQLite data, CLI output, HTTP caches, language-server responses, and account files. Each adapter labels its fidelity, keeps the last good reading, and shows stale, authentication, or error states rather than substituting 0.

That approach is honest, but it is also the maintenance burden. Open issues on September 29 reported an OpenCode 1.18 storage change, renamed OpenCode 2.x database tables, and Claude /usage output that no longer contained expected limit lines. Those are not theoretical concerns. They show how a provider ring can go blank while Codenotch itself remains healthy. If a quota display controls buying or scheduling decisions, compare it with the provider's own view after upgrades.

What happened when we ran it

Our lab targeted the Rust project under windows/ at commit 0083369. Dependency installation succeeded in 22 seconds and resolved 486 packages. The repository checkout contained 489 files, about 122,354 lines of source, and occupied 32.3 MB. Four CI workflow files were present, while our scan found no Dockerfile and no repository-level tests directory.

The release build failed after 190 seconds with exit code 101. The supplied log tail shows two warnings for unused imports and says one previous error prevented the codenotch binary from compiling, but that earlier error is absent from the excerpt. Tests failed after 20 seconds with the same exit code. Their tail shows 3 warnings, including an unused Windows test variable, followed by the same reference to one earlier compile error. Naming a cause would be guesswork.

macOS has the finished path; Windows and Linux carry caveats

The main download is a universal macOS application for macOS 15 or later. Its DMG is signed and notarized, and Sparkle checks daily for EdDSA-signed updates. Building from source needs Xcode, XcodeGen, and create-dmg, while a local development signature is recommended so repeated keychain prompts do not return on every launch. The app can run with fixed demo readings when you do not want it touching live accounts.

Windows uses Rust, Tauri 2, and WebView2. Its installer works without administrator rights, but it is not code-signed, so SmartScreen presents a warning that users must bypass. Automatic archives use a Tauri signature when maintainers configure the key; the manual installer remains unsigned. A Windows build needs the MSVC Rust toolchain. This is a meaningful difference from the polished macOS distribution, especially in managed corporate environments.

Linux builds from the same crate but requires GTK 3, WebKitGTK 4.1, AppIndicator, OpenSSL, and other development packages. Wayland cannot place the notch directly, so the launch script forces X11 through XWayland. The README lists 4 gaps: edge dragging, seen-state and terminal focus, Antigravity credential access, and installed executable icons. Linux is usable as an ongoing port, not equivalent to the Mac application.

Read-only access still reaches sensitive local state

Codenotch says it does not send prompts, tokens, credentials, or raw provider responses to the paired phone. Pairing stays on the local network, uses a single-use code, and expires after 5 minutes. The desktop side also describes provider access as read-only where possible. Codex credentials, for example, are read without being refreshed or written, and separate profiles must be renewed through Codex itself.

Read-only does not mean low sensitivity. The app may access keychain items, OAuth sessions, CLI credential files, editor databases, or browser sessions opened inside its own web view. Some environments will reasonably reject that boundary. Review each enabled adapter, switch off providers you do not need, and expect operating-system permission prompts. A team laptop with strict endpoint controls is a different fit from a personal development machine.

Version 1.20.0 shows fast work and fast-moving dependencies

GitHub showed 2,613 stars and 44 combined open issues and pull requests on September 30, 2026. The repository was pushed that day, and v1.20.0 was published minutes earlier. Its notes added project-level allowance costs, fresher readings during active work, and Windows changes. Current pull requests included Linux desktop work and more Windows placement behavior. This is active maintenance rather than a dormant widget.

The project was created on September 5, so that activity also sits inside a short history. Provider integrations have already needed repairs as upstream tools moved their files and response formats. Codenotch earns a trial if its glanceable display changes how you manage several paid plans. Keep the original tools' usage screens as the authority, and do not assume yesterday's adapter still reads today's session format.

Alternatives

ProjectWhat it isPick it when
CodexBar gh↗A macOS menu-bar app for watching Codex and Claude usage limits.pick this instead when a conventional menu-bar display is enough and the screen-edge notch adds no value.
Claude Code gh↗Anthropic's coding CLI includes its own usage view for the signed-in account.pick this instead when you only need Claude's own reading and do not want another app touching local sessions.
Codex gh↗OpenAI's coding agent exposes its account limits inside the tool itself.pick this instead when Codex is your only metered coding assistant.

What people are saying

  1. [velocity-scout] vinzdg/codenotch

Sources

  1. Codenotch README
  2. Codenotch Windows README
  3. Codenotch 1.20.0 release
  4. Codenotch repository

More dev tools reviews

swiftui-logo-draw · RTX40MFG-Unlock · astra-chatgpt-hyperframes · booking-microservices · macos-sysdata · NoGraphicsAPI · the whole board →