Sometimes a project lives partly outside your computer — at the bench,
the whiteboard, the breadboard. Project Notebook is a bridge from your
phone into the Claude Code session you’re already in: photos, voice
memos, videos, screenshots, files. Whatever just happened out there,
brought back in.
And the session writes down what you were thinking when it arrived,
attached to the file. A month later, the photo still means something.
Why this exists
I’m learning electronics. My desk is half breadboard, half terminal.
I’d snap a photo of a circuit that finally worked, mumble a voice memo
about why the 2.2 kΩ pull-ups beat the 4.7 kΩ ones,
then come back a week later staring at a photo of wires with no memory of
what I was looking at.
The pieces I needed already existed — AirDrop moves files, Claude Code
sits next to me while I work, my phone’s share sheet is right there.
What didn’t exist was the connection between them: a way to get the
artifact and the thinking-around-it into the same place, automatically.
Project Notebook is that connection.
How it works
Three moving parts. One library that grows.
Send anything from your phone — from any app’s share sheet, into a specific project you’re working on.
It gets filed in your project’s library — one tidy folder per project on your Mac, with everything the tools could figure out about each file alongside it.
Your session writes down what was happening — the conversation you’re in becomes the context attached to the file, so when you come back later, you still know what you were looking at.
01Install it
It’s a Python tool — install it like any other CLI. Then run check to see which features are turned on and how to turn on the rest (audio transcription, etc. — each backed by a small external tool you install separately).
$ uv tool install project-notebook$ project-notebook install-claude-code-skill
$ project-notebook check
# follow the install hints for anything off you want on
02Pair your phone
Run pair, point your phone’s camera at the QR code in the iOS app. Once.
$ project-notebook pair
# scan the QR with the Project Notebook iOS app
03Open a session
In any Claude Code session, run the skill. As long as the session is open, whatever you share from your phone lands here.
/notebook-register
What you’ll see when it’s working
Share a video from your phone. A moment later, your session says something like:
New artifact: IMG_8150.MOV
Processed: IMG_8150.MOV — meta, preview frame, audio
Processed: IMG_8150.MOV — transcript ready
# Claude reads the transcript, looks at the preview, and writes# a note about what was going on when you sent it — tied to# the file, on disk, for when you come back.
Go deeper
It’s a small, readable project. If you want to see the plumbing:
Architecture — how an artifact actually moves through the system.
Security model — what’s allowed to talk to what, and why.