vinzdg/codenotch
47.5
Weak · 15 November 2026
83.5k
lines of production code
Swift
with Rust, JavaScript
4
measurements over time
What this system is
Features
Introduce Phone Link feature with secure local pairing
Adds a new Phone Link capability that allows connecting a phone to the Mac over the local network. The implementation includes a local HTTP server (PhoneLinkServer) that listens on private network interfaces, a pairing flow (PhoneLinkPairing, PhoneLinkPairingView) that generates time-limited QR codes, and a crypto layer (PhoneLinkCrypto) using AES-GCM for encrypting wire traffic and HMAC-SHA256 for request signing. Secrets are stored in the macOS Keychain (PhoneLinkKeychainSecretStore) rather than local files, and paired devices are persisted in a local JSON registry (PhoneLinkRegistry). The feature is currently disabled by default (PhoneLink.isAvailable = false) until a companion phone app is available, and the server enforces local-network-only access, rate limiting, and nonce replay protection.
Sources/PhoneLink · high confidence
Introduce Windows port of Codenotch
This change adds the initial Windows implementation of the Codenotch application, a system tray utility that provides usage tracking and status for AI coding assistants. The port includes core modules for activity monitoring (Cursor, Codex, Antigravity), usage quota retrieval via the Antigravity CLI or local bridges, Claude authentication, and UI components such as the notch, backdrop, and carry mechanics. It also introduces platform-specific features like autostart via Windows Registry, ConPTY-based CLI execution, and adaptive pill theming.
windows/codenotch · high confidence
Local cost tracking and project-level spending attribution
The app now calculates local usage costs by reading session transcripts from Claude Code and Codex, attributing token consumption to specific projects, and displaying the estimated spend per project in the hover card and a new Activity window. Users can view daily, weekly, and monthly breakdowns of sessions, active time, and costs, with support for subscription and API billing models, automatic plan detection, and configurable currency exchange rates.
Sources/Features · high confidence
Menu bar usage limits, activity pulses, and session chimes
The menu bar item now displays usage limits (percentages and reset countdowns) for providers with five-hour windows, controlled by a new opt-in setting. Active provider icons pulse in the menu bar to indicate live activity, and session completion sounds are played via AVAudioPlayer to bypass system alert-sound settings. The app also enforces single-instance startup by retiring older copies and adds a TerminalCommand helper to run CLI sign-in commands in the user's preferred terminal emulator.
Sources/App · high confidence
New localization system and support for Claude Desktop usage cache
The app now includes a custom localization engine (L10n.swift) that allows users to override the system language setting independently of the OS, ensuring test stability and consistent UI copy. A comprehensive string catalog (Localizable.xcstrings) adds translations for multiple languages including German, French, Indonesian, Japanese, Korean, Portuguese (Brazil), Russian, Simplified/Traditional Chinese, Ukrainian, Uzbek, and Turkish. Additionally, the app can now read usage data from Claude Desktop's HTTP cache by vendoring the Zstandard decoder (v1.5.7) to decompress cached response bodies, a capability previously unavailable on macOS. The Info.plist also updates the minimum system version to macOS 15.0 and adds a network usage description for phone-link features.
Sources · high confidence
New model and usage tracking infrastructure for local runtimes and custom endpoints
The application now includes a comprehensive set of model types to support monitoring local AI runtimes (such as Ollama and LM Studio) and custom API endpoints. This includes \LocalModelBrand\ for automatic model identification, \LocalModelPerformance\ for tracking generation speed, \LocalRuntimeReading\ for monitoring loaded models and memory usage, and \LocalTokenLedger\ for maintaining a daily token usage history. Additionally, \CustomEndpoint\ has been introduced to manage user-defined API endpoints with secure keychain storage, health checks, and configurable usage tracking (currency or tokens). The system also features new watchers (\UsageLimitWatcher\, \UsageResetWatcher\, \ThresholdNotifier\) that detect limit exhaustion, usage resets, and threshold crossings (80%/100%) to trigger appropriate notifications via the notch or macOS banners.
Sources/Model · high confidence
New session activity monitors and ownership logic for Claude, Gemini, Grok, Kimi, and LM Studio
The application now includes dedicated activity monitors for several AI providers, allowing the interface to display real-time session states. Claude sessions are now correctly attributed to their specific account profiles even when hosted by the Claude desktop app, and their busy/idle status is determined by reading transcript files rather than relying on potentially missing registry status. Gemini activity is monitored across CLI, OpenCode, and Hermes sources, with Hermes sessions using database leases to detect active turns. Grok monitors both TUI and headless runs, scanning processes off the main thread to avoid UI lag. Kimi sessions are tracked by matching running processes to working directories and reading wire logs for turn states. Additionally, LM Studio metrics are now collected, showing loaded models, generation speed, and a daily token ledger.
Sources/Sessions · high confidence
New usage providers for Amp, Apify, and Google Antigravity
The app now monitors usage and quotas for three additional AI platforms. Amp support reads the API token from the local secrets file and displays agent and orb usage limits. Apify support retrieves the API token from the environment, settings, or CLI keychain to show the monthly platform spend against the account's custom usage cap. Google Antigravity support discovers multiple isolated user profiles (e.g., \\~/.gemini/antigravity-work\) and parses their quota envelopes to display usage for Gemini and third-party models like Claude and GPT.
Sources/Providers · high confidence
Behavioural changes
16 commits (2 fixes) modifying windows/scripts
A change to existing behaviour in windows/scripts — 16 commits (2 fixs), 9 files: “Add Korean on Windows”; “Word the card's renewal as the tray and the Mac do”; “Remaining mode, Muse provider, and remote Claude/Codex hosts”; and 13 more.
windows/scripts · medium confidence · unverified
4 commits (0 fixes) modifying Sources/Costs
A change to existing behaviour in Sources/Costs — 4 commits, 10 files: “Costs: act on a usage reading only when it changes”; “Cost per project: what each project spent of a login's allowance, on the card and in an Activity window”; “Cost indexer: stat() each transcript instead of attributesOfItem”; and 1 more.
Sources/Costs · medium confidence · unverified
47 commits (6 fixes) modifying windows
A change to existing behaviour in windows — 47 commits (6 fixs), 11 files: “Add Windows light theme CI guard”; “wip”; “Land a carried notch centred, and recentre on the edge it is on”; and 44 more (refs \#465, \#474).
windows · medium confidence · unverified
Codenotch 1.20.0 release with cost tracking and UI updates
This update introduces a new Costs section that displays project spending against login allowances on a daily, weekly, and monthly basis, along with live-updating figures and a countdown timer during active sessions. The menu bar item now dynamically adjusts its width to fit the text, and the app adds support for Abacus.AI credits for custom endpoints while ensuring OpenCode and Grok sessions remain signed in. The release also includes polished Portuguese (Brazil) localization and requires macOS 15.0 or later.
site · high confidence
Fixes persistent macOS keychain password prompts for local development builds
Local development builds of Codenotch no longer trigger repeated keychain access prompts on launch. This is achieved by introducing \Scripts/sign-local.sh\, which creates and applies a stable self-signed code-signing identity to the app bundle, allowing macOS to persist 'Always Allow' keychain grants. Additionally, \Scripts/fix-keychain-partitions.sh\ updates existing keychain items to include the app's Team ID in their partition list, resolving the specific mismatch that caused the prompt loop. A new test script (\Scripts/test-signing.sh\) validates the Makefile's signing logic against various certificate scenarios.
Scripts · high confidence
New Settings panel with extensive customization options
The Settings panel has been redesigned with a dark, flat aesthetic and titles for every pane. Users can now customize the notch's appearance with new surface styles (Liquid Glass, Dark glass, Solid black), size options (Small, Medium, Large), and accent colors. Usage tracking is more flexible, with options for color transition styles (Hard step, Colour ramp), weekly limit rings (Off, Inside, Outside), and menu bar limit visibility. The panel also includes new configuration views for custom endpoints, DeepSeek pricing, and local AI providers like LM Studio and Ollama, along with language and display preferences.
Sources/Settings · high confidence
Notch can now be dragged around the entire screen perimeter and auto-folds for full-screen apps
The notch is no longer restricted to a single edge; it can be dragged along the full screen border (top, right, bottom, left) and will smoothly wrap around corners as a single continuous shape. It also automatically folds away when a full-screen application is active, and the cursor is now correctly updated even when the notch is not the frontmost app.
Sources/Notch · high confidence
Redesigned Liquid Glass surfaces and appearance-aware color ramps
The Notch panel now uses a Liquid Glass aesthetic with a new Dark Glass surface style that maintains a black bezel appearance regardless of the Mac's system theme. Colors in the design system are now resolved dynamically based on the current appearance (Light or Dark mode) to ensure proper contrast, including specific adjustments for tooltips and usage rings. The usage ring's color now ramps continuously across the full 0-100% range using per-appearance interpolation. Additionally, the system supports macOS's 'Reduce Transparency' accessibility setting, which adjusts the glass effect accordingly.
Sources/DesignSystem · high confidence
Windows notch UI redesigned to match macOS layout and behavior
The Windows Codenotch interface has been rebuilt to mirror the macOS experience, introducing a pill-shaped notch that can be carried around the screen edges (including corners) via a move handle, with an adaptive folded state that blends with the background. The UI now features a hover card with a shaped tail, usage rings sized to 44px (matching the Mac's 44/70 ratio), and a settings window with a sidebar layout, Mica-style transparency, and controls for theme, notch size (Small/Medium/Large), and weekly ring style (including dashed). The notch respects Windows animation settings and reduced motion preferences, and the interface supports multiple edges (left, right, top, bottom) with appropriate mirroring and positioning of the pill, card, and tail.
windows/codenotch/ui · high confidence
Test coverage
Expanded test coverage for new providers and UI accessibility
Added comprehensive unit tests for the new Amp and Apify usage providers, including credential loading, API contract validation, rate-limit handling, and account resolution. Also added tests for the Antigravity profile discovery logic and account nickname persistence. New accessibility tests verify that ProviderRings, TooltipCards, and the SettingsView render correctly under both standard and reduced transparency modes.
Tests · high confidence
Dependencies
33 commits updating dependencies (6 manifests)
A dependency / build maintenance change in (dependencies) — 33 commits (1 fix), 6 files: “Codenotch 1.6.0”; “Codenotch 1.23.0: remaining mode, a Dock style, oMLX, remote Claude/Codex hosts”; “Codenotch 1.25.0: sessions by title, a lighter cost indexer, Krea, Japanese”; and 30 more.
(dependencies) · medium confidence · unverified
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Baseline
- First survey — no prior run to compare against. CAI 48.
Lenses
- Code Health 50
- Architecture 95
- Maturity 77
- Readiness 52
- Security 73
- Accessibility 34
- Performance 100
Changes since last survey
- 300 commits — 260 feature/other, 40 fixes
By area
- (repo) — 113 commits
- windows/codenotch — 65 commits
- Sources/Providers — 33 commits
- (root) — 15 commits
- Sources/App — 15 commits
- Sources/Localizable.xcstrings — 9 commits
- Sources/Notch — 7 commits
- Sources/Settings — 6 commits
- Sources/Features — 5 commits
- Sources/Sessions — 4 commits
- .github/workflows — 3 commits
- Sources/Costs — 3 commits
- Sources/Model — 3 commits
- site/Codenotch-1.20.0.dmg — 2 commits
- Scripts/opencode — 1 commit
- Sources/Assets.xcassets — 1 commit
- Sources/DesignSystem — 1 commit
- Tests/AntigravityQuotaFamilyTests.swift — 1 commit
- Tests/AppLanguageTests.swift — 1 commit
- Tests/BusyWaveTests.swift — 1 commit
Notable commits
- fix: Fix Windows update checks without signed feed
- fix: Fix retained controllers after display reconfiguration
- fix: Merge #377: fix(localization): polish Brazilian Portuguese translations
- fix: Merge #391: Fix Windows update checks before signing is configured
- fix: Merge #398: fix(providers): macOS — OpenCode reads its sign-in from SQLite opencode.db
- fix: Merge #409: fix(providers): start Antigravity's language server when the IDE is not running
- fix: Merge #411: fix(providers): read both OpenCode schemas, not just the 2.x one
- fix: Merge #418: fix(providers): DeepSeek reads the funded wallet, not the first one
- fix: Merge #431: bugfix: Restore notches on external displays after sleep/wake
- fix: Merge #433: fix: prune legacy Perplexity entries from UsageArchive
- fix: Merge #439: fix(sessions): leave out Claude sessions nobody has open
- fix: Merge #456: fix(notch): stop alwaysShow republishing the clock every second
- fix: Merge #471: Linux: fix notch hover and delayed curves under XWayland
- fix: Merge #476: fix(providers): OpenCode 2.x reads the database's live Go key before auth.json
- fix: Merge #478: fix(ollama): support totals request count in cloud usage API (#436)
- fix: Merge #480: fix(sessions): drop Pi turns whose Pi has quit
- fix: Merge #483: fix(antigravity): ask Cloud Code PA when the bridge answer is missing a family
- fix: Merge #485: fix(antigravity): never answer a quota family with another family's number
- fix: Merge #517: fix: Kiro CLI provider usage parsing and session detection (#367)
- fix: Merge #518: fix(grokbot): dim a reading past its reset, and find the active slot
- …and 280 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
vinzdg/codenotch was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 835550a342871779135b6484d6899161c5222f7c — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.