Troubleshooting

The hook needs to be installed first. Go to Settings → Hook and click Install if the status isn't green.

Also check which auto-accept tiers are enabled. Each action belongs to a tier — if you've only enabled Read, then Bash commands (which are Execute tier) will still ask for approval. Open the Questions window and check your tier settings.

One more thing: any Claude Code sessions that were already running before you installed the hook won't be affected. Open a new session and try again.

Restart your Claude Code session. The connection between CC Gate and Claude only applies to sessions that started after the hook was installed. Close your current Claude session, open a new one, and the hook will be active.

This means CC Gate has a newer version of the hook than what's currently installed. CC Gate will usually update it automatically. If it doesn't, go to Settings → Hook → click Uninstall, then click Install again. Start a new Claude Code session afterwards.

You need to have opened that folder in Claude Code at least once. CC Gate discovers projects by looking at Claude Code's session history — if you've never run Claude Code in that folder, CC Gate doesn't know it exists yet.

Open Claude Code in the project folder, send one message, then come back to CC Gate. It will appear on the next refresh.

This can happen if the same folder was accessed through different paths — for example, once directly and once through a symlink, or if you have two separate copies checked out in different places. Both entries work fine. They're genuinely different entries from Claude Code's point of view.

CC Gate updates on a schedule. By default it checks every 15 seconds, so the status can be up to 15 seconds behind. If you want faster updates, go to Settings → General → Refresh Interval and set it to 5 seconds.

Some tools are in categories that CC Gate doesn't recognise, and those always require manual approval — this is intentional for safety. If you know which tier the action belongs to, make sure that tier is enabled in the Questions window.

If the action never appears in CC Gate at all, it may be one that Claude Code handles without going through the permission system — like simple read-only commands.

The hook isn't installed, or the current Claude session started before you installed it. Check Settings → Hook — the status should be green. If it is, start a new Claude Code session.

CC Gate needs to see recent Claude Code activity in the project to generate a commit message. Run Claude Code in the project — even just send one message — then open the commit panel and try again.

Add a short note in the "What were you working on?" field — something like "fixing the login bug" or "adding dark mode" — and click Refine. CC Gate will use your hint to write a more accurate message without starting over from scratch.

Go to Settings → General → Refresh Interval and increase it. At 5 seconds, CC Gate runs frequent checks that use more power. Try 30 seconds or 60 seconds if you're on a laptop running on battery — you'll barely notice the difference in practice.

macOS sometimes blocks apps downloaded from the internet, especially if they're new to your Mac. To open CC Gate anyway:

Find CC Gate in your Applications folder. Right-click it and choose Open (don't just double-click). A dialog will appear asking if you're sure — click Open. You only need to do this once. After that, it opens normally.

CC Gate lives only in the menu bar — it has no Dock icon. If you don't see it, the app may not be running. Open Finder → Applications → double-click CC Gate to launch it.

If you launched it and still don't see the icon, your menu bar might be full. On Macs with a notch, some icons get hidden. Try using a menu bar manager like Bartender to make room, or check the Control Centre for hidden icons.

Open a report at GitHub Issues. Include your CC Gate version (Settings → About), your macOS version, and a short description of what happened and what you expected to happen instead. The more detail, the faster we can help.