project-notebook 0.1.0

Like AirDrop, but it lands in your Claude Code session. Share photos, voice memos, and videos from your phone straight into your active coding project.

Project Notebook

Like AirDrop, but it lands in your Claude Code session.

A local bridge from your phone's share sheet into the Claude Code session you're already in. Photos, voice memos, videos, screenshots — whatever just happened off-screen, brought back in. The session writes down what you were thinking when each artifact arrived, attached to the file. A month later, the photo still means something.

Landing page (with diagrams and the story): https://stevenlybeck.com/project-notebook/

What it does

• Phone → Mac → session. An iOS Share Extension uploads to a small hub running on your Mac, which notifies your active Claude Code session over a live pipe.
• Per-project library, automatic. Each artifact lands in ~/.project-notebook/artifacts/<project>/, sidecared with extracted metadata, audio, a preview frame, and a transcript.
• Session context becomes annotations. Claude reads each artifact as it arrives and writes a note back capturing what was happening when you shared it.

Install

uv tool install project-notebook
project-notebook install-claude-code-skill
project-notebook check    # see which features are on; install hints for the rest

Project Notebook itself has no optional features — the core hub, CLI, skill, and pairing are always available. Audio transcription and video-metadata extraction are backed by external tools you install separately. check tells you what's on and how to turn on the rest.

On Apple Silicon for transcription:

uv tool install mlx-whisper

For video metadata and preview frames:

brew install ffmpeg

Pair your phone

project-notebook pair    # prints a QR; scan it with the Project Notebook iOS app

The iOS app currently ships through private TestFlight. See docs/ios.md for the build/distribution state.

Open a session

In any Claude Code session:

/notebook-register

The skill holds a live pipe to the hub for the lifetime of the session — no TTLs, no staleness. Anything you share from your phone shows up as a notification in the conversation within seconds.

Architecture

• Landing page — diagrams and the why
• docs/architecture.md — the artifact pipeline, plane by plane
• docs/security.md — three-plane access model (Unix socket, LAN, loopback)
• docs/ios.md — iOS app + share extension
• docs/development.md — running from source

Status

Personal tool, alpha. The end-to-end loop works on Apple Silicon Macs with an iOS phone on the same LAN (or Tailscale). Cross-platform support and additional transcription backends are planned but not yet wired up.

License

MIT © Steven Lybeck