LLimit

skill
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in Scripts/package_app.sh
  • rm -rf — Recursive force deletion command in install.sh
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This is a native macOS menu-bar application that monitors and displays your Claude Code and Codex API usage limits across multiple accounts. It provides a real-time visual indicator of how much of your rate limits have been consumed.

Security Assessment
The application handles sensitive data, explicitly accessing local OAuth tokens and routing API requests to Anthropic servers. A major concern is that it implements its own PKCE OAuth login flow, meaning it intercepts browser callbacks and directly manages your authentication credentials. While no hardcoded secrets were found and it avoids requesting dangerous macOS system permissions, the installation methods present significant risks. The `curl | bash` piping method blindly downloads and runs remote code. Furthermore, both the installation and build scripts contain `rm -rf` recursive force deletion commands, which are standard for clearing build directories but could be destructive if improperly modified. Overall risk is rated as Medium.

Quality Assessment
The project is actively maintained, with its most recent code push occurring today. It benefits from clear documentation and a highly permissive MIT license. However, community trust and visibility are currently very low, with only 6 stars on GitHub. As an ad-hoc signed app, users must manually bypass macOS Gatekeeper security controls to run it.

Verdict
Use with caution — while the utility is actively maintained and useful, its low community validation, destructive script commands, and direct handling of sensitive OAuth tokens warrant a thorough manual code review before installation.
SUMMARY

Native macOS menu-bar app that shows Claude Code and Codex usage windows at a glance, across multiple accounts.

README.md

LLimit

A native macOS menu-bar app that shows how much of your Claude Code and
Codex usage windows you've burned through
— at a glance, across multiple
accounts, without leaving the keyboard.

Inspired by steipete/CodexBar,
but reuses your existing claude / codex CLI logins instead of
requiring a separate sign-in flow.

LLimit usage popover


Install

One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/githajae/LLimit/main/install.sh | bash

Downloads the latest release, installs to /Applications/LLimit.app,
strips the macOS quarantine flag (so Gatekeeper doesn't block first launch),
and opens the app. Apple Silicon only for now.

Manual install

  1. Grab the latest LLimit-<version>.zip from the
    Releases page.
  2. Unzip and drag LLimit.app into /Applications.
  3. The build is ad-hoc signed (no $99 Apple Developer account), so the first
    double-click will be blocked by Gatekeeper. Pick one:
    • Right-click → Open → Open in the dialog (older macOS).
    • System Settings → Privacy & Security → scroll to the LLimit
      message → Open Anyway (macOS 15+).
    • Terminal: xattr -dr com.apple.quarantine /Applications/LLimit.app

Build from source

Requires macOS 14+ and Xcode 15 / Swift 5.9.

git clone https://github.com/githajae/LLimit.git
cd LLimit
Scripts/package_app.sh                  # → build/release/LLimit.app
open build/release/LLimit.app

For a versioned, zipped artifact:

Scripts/package_app.sh 0.2.0 zip        # → build/release/LLimit-0.2.0.zip

Features

  • Live menu-bar icon — two stacked progress bars (5-hour / weekly) plus an
    optional headline percent. Color escalates orange ≥70%, red ≥90%.
  • Multiple accounts at once — list view up to 3 accounts, automatic
    2-column grid above that. Supports any mix of Claude and Codex configs.
  • Real plan-relative percentages
    • Claude: calls https://api.anthropic.com/api/oauth/usage with your
      existing OAuth token (5h, 7d, 7d opus, 7d sonnet).
    • Codex: parses ~/.codex/sessions/**/*.jsonl token_count events for the
      primary (5h) and secondary (weekly) rate-limit blocks.
  • Identity at a glance — surfaces email + plan tier (max plan,
    plus plan, …) under each account name.
  • Threshold notifications — configurable warn-at percentage; one
    notification per window per reset cycle.
  • Launch at login — toggle in General settings (uses
    SMAppService.mainApp).
  • Per-account login flow
    • Claude: replicates the claude login PKCE OAuth flow ourselves —
      opens your real browser to Anthropic's sign-in page, catches the
      callback at localhost:54545, and saves each bearer to its own JSON
      snapshot. Bypasses the Claude CLI's single-global-keychain limitation
      so multiple accounts coexist.
    • Codex: launches codex login in-process, captures the device-code
      URL, and snapshots the resulting auth.json into the per-account
      CODEX_HOME so two Codex configs don't share state.

How it reads usage

Provider Source
Claude GET https://api.anthropic.com/api/oauth/usage with the OAuth token
Codex ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl (token_count events)
Auth Per-account JSON at ~/Library/Application Support/LLimit/credentials/<uuid>.json (Claude) and <CODEX_HOME>/auth.json (Codex)

LLimit never sends data anywhere except to the same Anthropic OAuth
endpoint the Claude CLI itself uses.


Releasing (maintainers)

Scripts/release.sh 0.2.0 "What's new in this release"

The script verifies a clean tree, builds a universal .app, ad-hoc signs it,
zips it, tags v0.2.0, pushes the tag, and uploads the zip via gh release create. No notarization yet — users get a Gatekeeper warning on first launch.


License

MIT — see LICENSE.

Yorumlar (0)

Sonuc bulunamadi