From install to your first nod in a few minutes.
ShipNod listens to your coding agent through its official hooks, and gives it one extra tool: a way to ask you. Here is the setup, then what happens each time an agent needs you.
Getting started
Five steps, done once. You need Claude Code already installed and signed in.
-
1
Install the desktop app
Download ShipNod for macOS or Windows, open it, and sign in once with GitHub, Google or a code sent to your email. There's no password. ShipNod runs a small background service on your computer, and your code and your agents' work stay there.
-
2
Review the setup, then apply it
The app shows every change it will make to your Claude Code settings as a diff. Nothing is written until you apply it, the original is backed up, and Settings can remove all of it later.
What setup adds + 11 hooks that report status to ShipNod + ShipNod's tool server, so the agent can ask + a skill that says when to ask Backup saved. Undo any time in Settings. -
3
Turn it on in a project
Run one command inside a repository. It writes a short policy file you can edit. Projects where you haven't run it are left completely alone.
$ shipnod enable ShipNod is on in ~/code/checkout-api wrote .shipnod/policy.yaml -
4
Pair your phone
In the desktop app, open Machines and phones and show a pairing code. On your phone, open app.shipnod.dev, scan the QR code or type the code, and confirm that both screens show the same six digits. The phone needs no sign-in of its own.
Pairing codeK7QP9-X2M4ABoth screens show482 913 -
5
Work the way you already do
Start Claude Code in the terminal or in VS Code. When it reaches something your policy says to ask about, the question arrives as a card. You nod, and it continues.
CCNeeds decision checkout-api Store order status as a new column or a separate history table?
What happens when an agent needs you
The same four steps every time, whether you're at your desk or not.
- Step 1
The agent asks
It files the question with two to four options, the risk and cost of each, and its own recommendation.
- Step 2
ShipNod carries it to you
The service on your computer queues it, shows it in the desktop app, and sends a sealed copy to your paired phone.
- Step 3
You nod
Pick an option, write your own, add instructions, or snooze it for later. From either screen.
- Step 4
The agent continues
Your answer returns to the same session, even one that had gone idle, and is saved to DECISIONS.md in the project.
When you step away
Switch on Away mode and agents ask through ShipNod instead of their own question box, which would wait for nobody. Your phone gets a notification only it can read, and commands that need approval wait for your tap.
When nobody answers
For rules you marked "ask me, then go with its pick", the agent's recommendation applies after an hour and is logged that way. Rules marked "always ask me" keep waiting. If no ShipNod screen is open at all, approvals go straight back to the terminal's own prompt.
Common questions
Does ShipNod read my code?
No. It sees what your agent reports: session status, the questions it asks, and a one-line summary of commands that need approval, with anything that looks like a secret redacted. Files and transcripts are never copied.
Why do I sign in?
So ShipNod knows who to help when you ask, and can tell you about updates. You sign in once on each Mac with GitHub, Google or a code sent to your email; there's no password. Your account isn't linked to the relay, so the relay still can't tell who you are. Your agents keep working while you're signed out.
Does it use my Claude login or API key?
No. Your agent signs in exactly as before. ShipNod never reads, stores or forwards a credential, and it makes no AI calls of its own.
What can ShipNod's relay see?
Which of your devices are online, and encrypted messages it can't open. The keys are created on your computer and phone when you pair, and never leave them. A computer that never pairs a phone never contacts the relay at all.
What if ShipNod isn't running?
Your agent works as it always did, with its own prompts. ShipNod's hooks are built to step aside, never to block.
Which agents does it work with?
Claude Code today, in the terminal and in VS Code. More agents are planned.