{"id":51240140,"url":"https://github.com/marcel-breuer/tokenglance","last_synced_at":"2026-06-29T00:00:23.335Z","repository":{"id":367933087,"uuid":"1282817880","full_name":"marcel-breuer/tokenglance","owner":"marcel-breuer","description":"Local-first macOS menu bar app for monitoring token usage from AI coding tools.","archived":false,"fork":false,"pushed_at":"2026-06-28T10:19:53.000Z","size":2391,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T11:14:05.847Z","etag":null,"topics":["ai-tools","claude-code","codex","gemini-cli","macos","menubar","token-usage"],"latest_commit_sha":null,"homepage":"https://github.com/marcel-breuer/tokenglance","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marcel-breuer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-28T08:20:01.000Z","updated_at":"2026-06-28T10:19:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/marcel-breuer/tokenglance","commit_stats":null,"previous_names":["marcel-breuer/tokenglance"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/marcel-breuer/tokenglance","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcel-breuer%2Ftokenglance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcel-breuer%2Ftokenglance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcel-breuer%2Ftokenglance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcel-breuer%2Ftokenglance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcel-breuer","download_url":"https://codeload.github.com/marcel-breuer/tokenglance/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcel-breuer%2Ftokenglance/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34907985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-code","codex","gemini-cli","macos","menubar","token-usage"],"created_at":"2026-06-29T00:00:22.475Z","updated_at":"2026-06-29T00:00:23.330Z","avatar_url":"https://github.com/marcel-breuer.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TokenGlance\n\nTokenGlance is a local-first native macOS menu-bar app for monitoring token usage from local AI coding tools.\n\nDevelopment screenshot: placeholder until the first public release image is captured.\n\nTokenGlance refreshes automatically by default. Counts update when supported tools write exact local token metadata; the app does not estimate usage from prompt text.\n\n## Requirements\n\n- macOS 14 Sonoma or newer\n- Apple Silicon\n- No account, hosted backend, analytics, telemetry, Developer ID signing, or notarization\n\n## Supported Tools\n\n| Tool | Detection | Historical import | Live updates | Token categories | Accuracy | Setup required |\n| ---- | --------- | ----------------- | ------------ | ---------------- | -------- | -------------- |\n| Codex CLI | Yes | Yes, from verified local JSONL token metadata | Reconciliation | input, output, cached input, reasoning, total when present | Exact | No |\n| Claude Code | Yes | No by default | Telemetry parser available | input, output, cache read, cache creation | Exact when telemetry is configured | Yes |\n| Antigravity | Yes, via `agy --version` | Not yet | Not yet | Not yet verified | Unavailable until a documented local token metadata source is verified | Yes |\n\nAntigravity replaces Gemini CLI detection because the standalone Gemini CLI is no longer assumed to be available. TokenGlance detects Antigravity safely but does not read Antigravity conversations, logs, browser-style storage, or credentials until a documented local token metadata source is verified.\n\nCodex usage is imported from local token-count metadata in:\n\n```text\n~/.codex/sessions/\n~/.codex/archived_sessions/\n```\n\n## Privacy\n\nAll processing is local. TokenGlance does not upload usage data and does not read credentials, browser data, shell history, clipboard contents, prompts, responses, source code, or private provider APIs. Raw content encountered near metadata is discarded and never persisted.\n\nData is stored under:\n\n```text\n~/Library/Application Support/TokenGlance/\n```\n\n## Installation\n\nHomebrew personal tap:\n\n```bash\nbrew install --cask marcel-breuer/tap/tokenglance\n```\n\nTwo-step form:\n\n```bash\nbrew tap marcel-breuer/tap\nbrew install --cask tokenglance\n```\n\nTokenGlance is currently not signed with an Apple Developer ID and is not notarized by Apple. Homebrew 6 no longer accepts the old `--no-quarantine` install option. If macOS blocks the first launch, approve TokenGlance in System Settings \u003e Privacy \u0026 Security or remove the quarantine attribute for this app only:\n\n```bash\nxattr -dr com.apple.quarantine /Applications/TokenGlance.app\n```\n\nDo not globally disable Gatekeeper. Verify the published SHA-256 checksum before installing.\n\nManual installation:\n\n1. Download `TokenGlance-\u003cversion\u003e-arm64.zip` from the official GitHub release.\n2. Verify the published SHA-256 checksum.\n3. Extract `TokenGlance.app`.\n4. Move it to `/Applications`.\n5. Open it and approve the launch in macOS Privacy \u0026 Security if Gatekeeper blocks the first launch.\n\n## Development\n\n```bash\nswift build\nswift test\n./scripts/package-release.sh 0.1.1\n```\n\nDocker is preferred when available, but this repository is a native macOS app and requires the local macOS SDK/Xcode toolchain for build, test, and packaging.\n\n## Release\n\nThe release script builds an optimized ARM64 app, applies an ad-hoc signature, verifies the app bundle, creates a ZIP, and writes a SHA-256 checksum:\n\n```bash\n./scripts/package-release.sh 0.1.1\n```\n\nArtifacts:\n\n- `dist/TokenGlance.app`\n- `dist/TokenGlance-0.1.1-arm64.zip`\n- `dist/TokenGlance-0.1.1-arm64.zip.sha256`\n\nThe GitHub release workflow updates the Homebrew cask after creating the release.\nConfigure `HOMEBREW_TAP_TOKEN` as a repository secret with write access to the tap\nrepository. The workflow defaults to `marcel-breuer/homebrew-tap`; set the\nrepository variable `HOMEBREW_TAP_REPOSITORY` to override it.\n\n## Export And Deletion\n\nTokenGlance supports CSV and JSON export of normalized usage metadata only. Deleting local usage data removes TokenGlance’s database records and collector cursors; it never modifies source files belonging to external tools.\n\n## Roadmap\n\n- User-approved Claude Code telemetry setup helper.\n- User-approved Antigravity token metadata setup when a documented local source is verified.\n- Additional collectors only after documented local metadata sources are verified.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcel-breuer%2Ftokenglance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcel-breuer%2Ftokenglance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcel-breuer%2Ftokenglance/lists"}