codehatch

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

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?

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.