https://github.com/ai-fresh/ccgate
macOS menu bar app for managing Claude Code sessions, permissions, and auto-accept hooks
https://github.com/ai-fresh/ccgate
ai ai-tools anthropic claude claude-code developer-tools llm macos macos-app menubar menubar-app productivity swift swiftui
Last synced: 4 months ago
JSON representation
macOS menu bar app for managing Claude Code sessions, permissions, and auto-accept hooks
- Host: GitHub
- URL: https://github.com/ai-fresh/ccgate
- Owner: ai-fresh
- License: mit
- Created: 2026-02-07T16:39:53.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-21T01:16:50.000Z (4 months ago)
- Last Synced: 2026-02-21T02:20:36.850Z (4 months ago)
- Topics: ai, ai-tools, anthropic, claude, claude-code, developer-tools, llm, macos, macos-app, menubar, menubar-app, productivity, swift, swiftui
- Language: HTML
- Homepage: https://ai-fresh.github.io/ccgate
- Size: 1.7 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
CC Gate
Monitor and manage Claude Code sessions from your macOS menu bar.
Auto-approve tool permissions, track active sessions, and handle Claude's questions — without leaving your workflow.
Features ·
Installation ·
Quick Start ·
Auto-Accept ·
FAQ
---
Left: Menu bar popup with project list, session counts, and status indicators. Right: Questions window with 4-tier auto-accept control and live stats.
---
## Why CC Gate?
If 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.
- **No more "Allow Bash?"** — Set permission tiers and let CC Gate auto-approve trusted operations
- **See everything at a glance** — Live status for all your Claude Code sessions in one place
- **Stay in control** — Review and respond to Claude's questions from a clean native UI
## Features
### Live Session Monitoring
All your Claude Code projects in one place. Each project shows:
- **Real-time status** — active (green dots), waiting for input (red bell), or idle (orange dots)
- **Last activity** — "1s ago", "2m ago", "1d ago"
- **Session count** — how many Claude Code sessions are running per project
- **Quick search** — filter projects instantly with the search bar
### 4-Tier Auto-Accept Permissions
Granular, hierarchical control over what Claude can do without asking:
| Tier | Tools | Risk |
|:-----|:------|:-----|
| **Read** | Read, Glob, Grep, WebSearch, WebFetch | Minimal — read-only |
| **Write** | Edit, Write, MultiEdit, NotebookEdit | Low — reversible with git |
| **Execute** | Bash (all terminal commands) | High — full shell access |
| **Plan** | ExitPlanMode | Minimal — approves plans |
Each tier is an independent toggle. Unknown tools always require manual approval.
### Question Management
When Claude asks for permission, CC Gate shows it instantly:
- **Pending questions** appear in real-time with project context
- **One-click approve/deny** from the native UI
- **Auto-accept stats** — track how many operations were auto-approved (e.g., "719 auto-accepted")
- **History view** with timestamps and decision log
### Hook-Based Architecture
CC Gate integrates with Claude Code through its native **PermissionRequest hook** — no hacks, no terminal scraping:
```
Claude Code ──→ Permission Hook ──→ CC Gate ──→ Allow / Deny
│
Auto-accept
(if tier enabled)
```
The hook is installed and managed entirely through the app UI. No manual config.
### Additional Features
- **Floating windows** — Settings, Questions, and Project List windows stay on top
- **Launch at Login** — start CC Gate automatically when you log in
- **One-click project opening** — launch any project in Terminal, VS Code, Cursor, iTerm, or Warp
- **New project creation** — create Claude Code projects directly from the menu bar
- **Auto-update checker** — get notified when a new version is available
- **Polish & English** localization
## Installation
### Requirements
- macOS 13.0 (Ventura) or later
### Step-by-step
1. **Download DMG**
- Get `CC Gate-X.Y.Z.dmg` from the [latest release](https://github.com/ai-fresh/ccgate/releases/latest)
2. **Install Application**
- Open the DMG file
- **Drag** `CC Gate.app` to your **Applications** folder
3. **Launch & Setup Hook**
- Open **CC Gate** from Applications folder
- Menu bar icon appears (terminal icon in top bar)
- Go to **Settings → Hook → Install** (one-time setup)
You're ready! All Claude Code sessions will appear in the project list.
## Quick Start
1. **Click the terminal icon** in your menu bar to open CC Gate
2. **Install the hook** — Settings → Hook → Install (one-time setup)
3. **Configure auto-accept** — open Questions window (bell icon) and toggle the tiers you want
4. **Start coding** — CC Gate monitors your sessions automatically
That's it. All Claude Code sessions from `~/.claude/projects/` will appear in the project list with live status.
## Auto-Accept Tiers
Detailed tool mapping
| Tier | Tools |
|:-----|:------|
| Read | `Read`, `Glob`, `Grep`, `WebSearch`, `WebFetch`, `LS`, `Task`, `TodoRead` |
| Write | `Edit`, `Write`, `MultiEdit`, `NotebookEdit`, `TodoWrite` |
| Execute | `Bash` (all terminal commands) |
| Plan | `ExitPlanMode` |
> [!TIP]
> For most workflows, enabling **Read + Write** gives a good balance of speed and safety. Enable **Execute** only when you trust the codebase fully.
## Session Status
| Indicator | Status | Meaning |
|:---------:|:-------|:--------|
| 🟢 | Active | Claude is working (updated < 60s ago) |
| 🔔 | Waiting | Claude has a pending question |
| 🟠 | Idle | No recent activity (> 60s) |
## Settings
CC Gate includes a full Settings window with four tabs:
- **General** — launch at login, new projects folder, default app (Terminal/VS Code/Cursor/iTerm/Warp), refresh interval, question expiration
- **Permissions** — Accessibility and Automation permission status with one-click setup
- **Hook** — install/uninstall the permission hook, view status
- **About** — version info, update checker, feature overview
## Requirements
- **macOS 13.0** (Ventura) or later
- **Claude Code CLI** installed and configured
- Internet connection for initial setup
## FAQ
Is it safe to auto-accept Execute (Bash)?
The 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.
Does CC Gate work with multiple projects?
Yes. 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.
What happens if CC Gate is closed?
Claude 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.
Can I use it without auto-accept?
Absolutely. Keep all tiers disabled and use CC Gate purely as a session monitor and question management UI.
The hook shows "not installed" after updating
The hook signature changed in v2.6.0. Go to Settings → Hook → Uninstall, then Install again. This is a one-time step after the update.
What data does CC Gate collect?
CC 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.
## Contributing
Contributions are welcome! The source code is available at [ccgate-source](https://github.com/ai-fresh/ccgate-source).
## License
MIT License — see [LICENSE](LICENSE) for details.
---
Built with SwiftUI for the Claude Code community