Help
The common questions, with the quick fix for each.
A session doesn’t update live
Sessions started before you installed codehatch don’t send live updates. Restart each one once: type /exit, then claude --continue to carry on where you were. In VS Code or Cursor, quitting and reopening the editor restarts them all; then claude --continue in each. Also check that Use hooks for live updates is on in Settings › Sessions.
My Codex sessions don’t update live
Codex asks before it runs new hooks. In a Codex session, type /hooks and approve codehatch’s. Sessions open before that need a restart: codex resume --last carries on where you were.
Clicking a session in VS Code or Cursor does nothing
- The first time, your editor asks to let codehatch’s helper open a link: tick Don’t ask again, then Open.
- After installing or updating codehatch, reload your editor windows (Developer: Reload Window), or quit and reopen the editor, so the helper runs.
- Check the helper is installed: Settings › General › Editor helper.
Clicking a session in Terminal or iTerm2 does nothing
codehatch needs your permission to bring the right tab forward. Turn it on in System Settings › Privacy & Security › Automation › codehatch.
A closed session reopens in the wrong app
A closed session reopens where it last ran, if codehatch saw it open. To always use one app, pick it in Settings › Sessions › Resume them in.
I don’t have a notch
It works on any Mac. Without a notch, it’s a small black tab at the top centre of the screen.
How do I hide a repo?
Settings › Privacy › Never show these repos. Its sessions are left out everywhere.
How do I update?
Updates arrive by themselves. To check now: Settings › General › Check now.
How do I uninstall it?
- Turn off Use hooks for live updates in Settings › Sessions. That removes the hooks from Claude Code and Codex.
- Quit codehatch and move it from Applications to the Trash.
- In VS Code or Cursor, uninstall codehatch helper from the Extensions list.
- Optionally, delete the
~/.codehatchfolder.
Does it send my code or prompts anywhere?
No. Everything stays on your Mac. The privacy policy has every detail.
Something else?
Ask on the issue tracker on GitHub.