{"id":44105127,"url":"https://github.com/ai-fresh/ccgate","last_synced_at":"2026-03-03T01:01:39.045Z","repository":{"id":337083388,"uuid":"1152281676","full_name":"ai-fresh/ccgate","owner":"ai-fresh","description":"macOS menu bar app for managing Claude Code sessions, permissions, and auto-accept hooks","archived":false,"fork":false,"pushed_at":"2026-02-21T01:16:50.000Z","size":1779,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-21T02:20:36.850Z","etag":null,"topics":["ai","ai-tools","anthropic","claude","claude-code","developer-tools","llm","macos","macos-app","menubar","menubar-app","productivity","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://ai-fresh.github.io/ccgate","language":"HTML","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/ai-fresh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-07T16:39:53.000Z","updated_at":"2026-02-20T10:44:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ai-fresh/ccgate","commit_stats":null,"previous_names":["ai-fresh/ccmanager","ai-fresh/ccgate"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/ai-fresh/ccgate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ai-fresh%2Fccgate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ai-fresh%2Fccgate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ai-fresh%2Fccgate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ai-fresh%2Fccgate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ai-fresh","download_url":"https://codeload.github.com/ai-fresh/ccgate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ai-fresh%2Fccgate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30028228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T00:31:48.536Z","status":"ssl_error","status_checked_at":"2026-03-03T00:30:56.176Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","ai-tools","anthropic","claude","claude-code","developer-tools","llm","macos","macos-app","menubar","menubar-app","productivity","swift","swiftui"],"created_at":"2026-02-08T15:04:41.089Z","updated_at":"2026-03-03T01:01:39.025Z","avatar_url":"https://github.com/ai-fresh.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" width=\"128\" height=\"128\" alt=\"CC Gate Logo\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eCC Gate\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMonitor and manage Claude Code sessions from your macOS menu bar.\u003c/strong\u003e\u003cbr\u003e\n  Auto-approve tool permissions, track active sessions, and handle Claude's questions — without leaving your workflow.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ai-fresh/ccgate/releases/tag/LATEST\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/ai-fresh/ccgate?style=flat-square\u0026color=blue\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-13.0%2B-blue?style=flat-square\" alt=\"macOS 13.0+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Swift-5.9-orange?style=flat-square\" alt=\"Swift 5.9\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-green?style=flat-square\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e ·\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e ·\n  \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e ·\n  \u003ca href=\"#auto-accept-tiers\"\u003eAuto-Accept\u003c/a\u003e ·\n  \u003ca href=\"#faq\"\u003eFAQ\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshots/main-window.png\" width=\"280\" alt=\"CC Gate — Project list with live session status\"\u003e\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"assets/screenshots/questions-window.png\" width=\"400\" alt=\"CC Gate — Auto-Accept tiers and question management\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eLeft: Menu bar popup with project list, session counts, and status indicators. Right: Questions window with 4-tier auto-accept control and live stats.\u003c/sub\u003e\n\u003c/p\u003e\n\n---\n\n## Why CC Gate?\n\nIf you use [Claude Code](https://claude.ai/code), you know the drill — every file read, every shell command, every edit requires manual approval in the terminal. CC Gate sits in your menu bar and handles that for you, so Claude can keep working while you focus on what matters.\n\n- **No more \"Allow Bash?\"** — Set permission tiers and let CC Gate auto-approve trusted operations\n- **See everything at a glance** — Live status for all your Claude Code sessions in one place\n- **Stay in control** — Review and respond to Claude's questions from a clean native UI\n\n## Features\n\n### Live Session Monitoring\n\nAll your Claude Code projects in one place. Each project shows:\n- **Real-time status** — active (green dots), waiting for input (red bell), or idle (orange dots)\n- **Last activity** — \"1s ago\", \"2m ago\", \"1d ago\"\n- **Session count** — how many Claude Code sessions are running per project\n- **Quick search** — filter projects instantly with the search bar\n\n### 4-Tier Auto-Accept Permissions\n\nGranular, hierarchical control over what Claude can do without asking:\n\n| Tier | Tools | Risk |\n|:-----|:------|:-----|\n| **Read** | Read, Glob, Grep, WebSearch, WebFetch | Minimal — read-only |\n| **Write** | Edit, Write, MultiEdit, NotebookEdit | Low — reversible with git |\n| **Execute** | Bash (all terminal commands) | High — full shell access |\n| **Plan** | ExitPlanMode | Minimal — approves plans |\n\nEach tier is an independent toggle. Unknown tools always require manual approval.\n\n### Question Management\n\nWhen Claude asks for permission, CC Gate shows it instantly:\n- **Pending questions** appear in real-time with project context\n- **One-click approve/deny** from the native UI\n- **Auto-accept stats** — track how many operations were auto-approved (e.g., \"719 auto-accepted\")\n- **History view** with timestamps and decision log\n\n### Hook-Based Architecture\n\nCC Gate integrates with Claude Code through its native **PermissionRequest hook** — no hacks, no terminal scraping:\n\n```\nClaude Code ──→ Permission Hook ──→ CC Gate ──→ Allow / Deny\n                                       │\n                                  Auto-accept\n                                  (if tier enabled)\n```\n\nThe hook is installed and managed entirely through the app UI. No manual config.\n\n### Additional Features\n\n- **Floating windows** — Settings, Questions, and Project List windows stay on top\n- **Launch at Login** — start CC Gate automatically when you log in\n- **One-click project opening** — launch any project in Terminal, VS Code, Cursor, iTerm, or Warp\n- **New project creation** — create Claude Code projects directly from the menu bar\n- **Auto-update checker** — get notified when a new version is available\n- **Polish \u0026 English** localization\n\n## Installation\n\n### Requirements\n- macOS 13.0 (Ventura) or later\n\n### Step-by-step\n\n1. **Download DMG**\n   - Get `CC Gate-X.Y.Z.dmg` from the [latest release](https://github.com/ai-fresh/ccgate/releases/latest)\n\n2. **Install Application**\n   - Open the DMG file\n   - **Drag** `CC Gate.app` to your **Applications** folder\n\n3. **Launch \u0026 Setup Hook**\n   - Open **CC Gate** from Applications folder\n   - Menu bar icon appears (terminal icon in top bar)\n   - Go to **Settings → Hook → Install** (one-time setup)\n\nYou're ready! All Claude Code sessions will appear in the project list.\n\n## Quick Start\n\n1. **Click the terminal icon** in your menu bar to open CC Gate\n2. **Install the hook** — Settings → Hook → Install (one-time setup)\n3. **Configure auto-accept** — open Questions window (bell icon) and toggle the tiers you want\n4. **Start coding** — CC Gate monitors your sessions automatically\n\nThat's it. All Claude Code sessions from `~/.claude/projects/` will appear in the project list with live status.\n\n## Auto-Accept Tiers\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDetailed tool mapping\u003c/strong\u003e\u003c/summary\u003e\n\n| Tier | Tools |\n|:-----|:------|\n| Read | `Read`, `Glob`, `Grep`, `WebSearch`, `WebFetch`, `LS`, `Task`, `TodoRead` |\n| Write | `Edit`, `Write`, `MultiEdit`, `NotebookEdit`, `TodoWrite` |\n| Execute | `Bash` (all terminal commands) |\n| Plan | `ExitPlanMode` |\n\n\u003c/details\u003e\n\n\u003e [!TIP]\n\u003e For most workflows, enabling **Read + Write** gives a good balance of speed and safety. Enable **Execute** only when you trust the codebase fully.\n\n## Session Status\n\n| Indicator | Status | Meaning |\n|:---------:|:-------|:--------|\n| 🟢 | Active | Claude is working (updated \u003c 60s ago) |\n| 🔔 | Waiting | Claude has a pending question |\n| 🟠 | Idle | No recent activity (\u003e 60s) |\n\n## Settings\n\nCC Gate includes a full Settings window with four tabs:\n\n- **General** — launch at login, new projects folder, default app (Terminal/VS Code/Cursor/iTerm/Warp), refresh interval, question expiration\n- **Permissions** — Accessibility and Automation permission status with one-click setup\n- **Hook** — install/uninstall the permission hook, view status\n- **About** — version info, update checker, feature overview\n\n## Requirements\n\n- **macOS 13.0** (Ventura) or later\n- **Claude Code CLI** installed and configured\n- Internet connection for initial setup\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eIs it safe to auto-accept Execute (Bash)?\u003c/strong\u003e\u003c/summary\u003e\n\nThe Execute tier gives Claude full terminal access — it can run any command. Only enable this if you trust the codebase and Claude's judgment. For most workflows, enabling Read + Write is a good balance of speed and safety.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDoes CC Gate work with multiple projects?\u003c/strong\u003e\u003c/summary\u003e\n\nYes. CC Gate monitors all Claude Code sessions in `~/.claude/projects/` and displays them in a single list with per-project status. In the footer you can see total project count and status breakdown.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat happens if CC Gate is closed?\u003c/strong\u003e\u003c/summary\u003e\n\nClaude Code falls back to its default behavior — asking for permission in the terminal. CC Gate is purely additive; closing it changes nothing about how Claude Code works.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I use it without auto-accept?\u003c/strong\u003e\u003c/summary\u003e\n\nAbsolutely. Keep all tiers disabled and use CC Gate purely as a session monitor and question management UI.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eThe hook shows \"not installed\" after updating\u003c/strong\u003e\u003c/summary\u003e\n\nThe hook signature changed in v2.6.0. Go to Settings → Hook → Uninstall, then Install again. This is a one-time step after the update.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat data does CC Gate collect?\u003c/strong\u003e\u003c/summary\u003e\n\nCC Gate reads session data from `~/.claude/projects/` (local files only). The hook exchanges question/answer files via `~/.claude/.ccmanager/`. No data is sent to external servers beyond the initial email authentication check.\n\n\u003c/details\u003e\n\n## Contributing\n\nContributions are welcome! The source code is available at [ccgate-source](https://github.com/ai-fresh/ccgate-source).\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eBuilt with SwiftUI for the Claude Code community\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fai-fresh%2Fccgate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fai-fresh%2Fccgate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fai-fresh%2Fccgate/lists"}