project-notebook 0.1.0__tar.gz

project_notebook-0.1.0/.claude/settings.local.json

@@ -0,0 +1,68 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python3 test_server.py)",
+      "Bash(curl:*)",
+      "Bash(pkill -f test_server.py)",
+      "Bash(python3 /Users/stevenlybeck/projects/project-notebook/test_server.py)",
+      "Bash(pkill -f hub.py)",
+      "Bash(python3 hub.py)",
+      "Bash(python3 -c ':*)",
+      "Bash(pip3 install:*)",
+      "Bash(python3:*)",
+      "Bash(uv init:*)",
+      "Bash(uv add:*)",
+      "Bash(uv run:*)",
+      "Bash(osascript -e 'display notification \"Hub test\" with title \"Project Notebook\"')",
+      "Bash(touch ~/Downloads/test_watcher_probe.txt)",
+      "Bash(rm ~/Downloads/test_watcher_probe.txt)",
+      "Bash(ls:*)",
+      "Bash(mdls:*)",
+      "Bash(brew list:*)",
+      "Bash(brew install:*)",
+      "Bash(xcodegen generate:*)",
+      "Bash(xcodebuild -project ProjectNotebook.xcodeproj -scheme ProjectNotebook -destination 'generic/platform=iOS' -quiet build)",
+      "Read(//Applications/**)",
+      "Bash(mdfind \"kMDItemCFBundleIdentifier == 'com.apple.dt.Xcode'\")",
+      "Bash(scutil --get LocalHostName)",
+      "WebSearch",
+      "Bash(git add:*)",
+      "Bash(git reset:*)",
+      "Bash(git rm:*)",
+      "Bash(git commit:*)",
+      "Bash(uv remove:*)",
+      "Bash(ps:*)",
+      "Bash(sips -g pixelWidth -g pixelHeight -g format -g hasAlpha /Users/stevenlybeck/projects/project-notebook/icon.jpg)",
+      "Bash(sips -g pixelWidth -g pixelHeight -g format -g hasAlpha -g space /Users/stevenlybeck/projects/project-notebook/icon.png)",
+      "Bash(sips *)",
+      "Bash(git *)",
+      "Bash(uv build *)",
+      "Bash(unzip -l dist/*.whl)",
+      "Bash(rm .claude/skills/notebook-register/project-notebook)",
+      "Bash(rmdir .claude/skills/notebook-register .claude/skills)",
+      "Bash(lsof -nP -iTCP:9999 -sTCP:LISTEN)",
+      "Bash(uv tool *)",
+      "Bash(cd *)",
+      "WebFetch(domain:nonstrict.eu)",
+      "Bash(awk '/Begin PBXSourcesBuildPhase section/,/End PBXSourcesBuildPhase section/' ios/ProjectNotebook/ProjectNotebook.xcodeproj/project.pbxproj)",
+      "WebFetch(domain:www.avanderlee.com)",
+      "WebFetch(domain:useyourloaf.com)",
+      "WebFetch(domain:wwdcbysundell.com)",
+      "WebFetch(domain:docs.aiohttp.org)",
+      "Bash(tailscale ip *)",
+      "Bash(ffmpeg -version)",
+      "Bash(lsof -nP -iTCP:9876 -sTCP:LISTEN)",
+      "Read(//private/tmp/**)",
+      "Bash(xargs -I {} sh -c 'echo \"--- {} ---\"; cat \"{}\"; echo; echo \"--- siblings ---\"; ls \"$\\(dirname {}\\)\"')",
+      "Bash(gh auth *)",
+      "Bash(grep -iE \"\\\\.\\(env|pem|p12|key|mobileprovision|crt|cer\\)$|secret|credential\")",
+      "Bash(gh repo *)",
+      "Bash(open docs/index.html)",
+      "Bash(gh api *)",
+      "Bash(whisper-cli --help)",
+      "Read(//opt/homebrew/Cellar/whisper-cpp/1.8.2/share/whisper-cpp/**)",
+      "Read(//Users/stevenlybeck/.local/share/uv/tools/project-notebook/bin/**)",
+      "Bash(/Users/stevenlybeck/.local/share/uv/tools/project-notebook/bin/mlx_whisper --help)"
+    ]
+  }
+}

project_notebook-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# macOS
+.DS_Store
+
+# Artifacts (user data, not source)
+artifacts/
+
+# Xcode
+ios/ProjectNotebook/ProjectNotebook.xcodeproj/xcuserdata/
+*.xcuserstate
+DerivedData/

project_notebook-0.1.0/.obsidian/app.json

@@ -0,0 +1 @@
+{}

project_notebook-0.1.0/.obsidian/appearance.json

@@ -0,0 +1 @@
+{}

project_notebook-0.1.0/.obsidian/core-plugins.json

@@ -0,0 +1,33 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": true,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "footnotes": false,
+  "properties": true,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": false,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": true,
+  "bases": true,
+  "webviewer": false
+}

project_notebook-0.1.0/.obsidian/workspace.json

@@ -0,0 +1,210 @@
+{
+  "main": {
+    "id": "2553c5a5be9f7154",
+    "type": "split",
+    "children": [
+      {
+        "id": "8671934280fa2bd1",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "c62807bc4e33cc5b",
+            "type": "leaf",
+            "state": {
+              "type": "markdown",
+              "state": {
+                "file": "docs/architecture.md",
+                "mode": "source",
+                "source": false
+              },
+              "icon": "lucide-file",
+              "title": "architecture"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "vertical"
+  },
+  "left": {
+    "id": "a0d7094d74ccc8de",
+    "type": "split",
+    "children": [
+      {
+        "id": "01187edc44ce3512",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "98597d96dbee47ee",
+            "type": "leaf",
+            "state": {
+              "type": "file-explorer",
+              "state": {
+                "sortOrder": "alphabetical",
+                "autoReveal": false
+              },
+              "icon": "lucide-folder-closed",
+              "title": "Files"
+            }
+          },
+          {
+            "id": "8962046dd5e8f9b2",
+            "type": "leaf",
+            "state": {
+              "type": "search",
+              "state": {
+                "query": "",
+                "matchingCase": false,
+                "explainSearch": false,
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical"
+              },
+              "icon": "lucide-search",
+              "title": "Search"
+            }
+          },
+          {
+            "id": "d0043373e920cf48",
+            "type": "leaf",
+            "state": {
+              "type": "bookmarks",
+              "state": {},
+              "icon": "lucide-bookmark",
+              "title": "Bookmarks"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300
+  },
+  "right": {
+    "id": "3c11d2921ae77125",
+    "type": "split",
+    "children": [
+      {
+        "id": "e5cb0a4b6124da9c",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "64e962a6468a599e",
+            "type": "leaf",
+            "state": {
+              "type": "backlink",
+              "state": {
+                "file": "docs/architecture.md",
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical",
+                "showSearch": false,
+                "searchQuery": "",
+                "backlinkCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-coming-in",
+              "title": "Backlinks for architecture"
+            }
+          },
+          {
+            "id": "d6f58cc09dafee48",
+            "type": "leaf",
+            "state": {
+              "type": "outgoing-link",
+              "state": {
+                "file": "docs/architecture.md",
+                "linksCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-going-out",
+              "title": "Outgoing links from architecture"
+            }
+          },
+          {
+            "id": "4b710d184717f843",
+            "type": "leaf",
+            "state": {
+              "type": "tag",
+              "state": {
+                "sortOrder": "frequency",
+                "useHierarchy": true,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-tags",
+              "title": "Tags"
+            }
+          },
+          {
+            "id": "7a014707412a2a90",
+            "type": "leaf",
+            "state": {
+              "type": "all-properties",
+              "state": {
+                "sortOrder": "frequency",
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-archive",
+              "title": "All properties"
+            }
+          },
+          {
+            "id": "ae8e8106c4528cd4",
+            "type": "leaf",
+            "state": {
+              "type": "outline",
+              "state": {
+                "file": "docs/architecture.md",
+                "followCursor": false,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-list",
+              "title": "Outline of architecture"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300,
+    "collapsed": true
+  },
+  "left-ribbon": {
+    "hiddenItems": {
+      "switcher:Open quick switcher": false,
+      "graph:Open graph view": false,
+      "canvas:Create new canvas": false,
+      "daily-notes:Open today's daily note": false,
+      "templates:Insert template": false,
+      "command-palette:Open command palette": false,
+      "bases:Create new base": false
+    }
+  },
+  "active": "98597d96dbee47ee",
+  "lastOpenFiles": [
+    "LICENSE",
+    "src/project_notebook/processors/__pycache__/transcribe.cpython-312.pyc",
+    "src/project_notebook/processors/__pycache__/extract.cpython-312.pyc",
+    "src/project_notebook/processors/transcribe.py",
+    "src/project_notebook/processors/extract.py",
+    "src/project_notebook/__pycache__/tools.cpython-312.pyc",
+    "src/project_notebook/tools.py",
+    "docs/index.html",
+    "src/project_notebook/processors/__pycache__/whisper.cpython-312.pyc",
+    "src/project_notebook/processors/__pycache__/ffmpeg.cpython-312.pyc",
+    "src/project_notebook/processors/__pycache__/__init__.cpython-312.pyc",
+    "docs/development.md",
+    "src/project_notebook/skill/SKILL.md",
+    "README.md",
+    "docs/security.md",
+    "docs/ios.md",
+    "ios/ProjectNotebook/ProjectNotebook/Assets.xcassets/AppIcon.appiconset/icon-1024.png",
+    "icon.png",
+    "icon.jpg",
+    "docs/architecture.md",
+    "PLAN.md"
+  ]
+}

project_notebook-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

project_notebook-0.1.0/CLAUDE.md

@@ -0,0 +1,4 @@
+# Project Notebook
+
+## Setup
+- Always use `uv` for Python dependencies and running Python code (`uv add`, `uv run`).

project_notebook-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steven Lybeck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

project_notebook-0.1.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: project-notebook
+Version: 0.1.0
+Summary: 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-URL: Homepage, https://stevenlybeck.com/project-notebook/
+Project-URL: Source, https://github.com/stevenlybeck/project-notebook
+Project-URL: Issues, https://github.com/stevenlybeck/project-notebook/issues
+Author-email: Steven Lybeck <slybeck@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: airdrop,artifacts,claude-code,ios,share-extension,transcription,voice-memo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.13.5
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segno>=1.6.1
+Requires-Dist: zeroconf>=0.131.0
+Description-Content-Type: text/markdown
+
+# 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
+
+```sh
+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:
+
+```sh
+uv tool install mlx-whisper
+```
+
+For video metadata and preview frames:
+
+```sh
+brew install ffmpeg
+```
+
+## Pair your phone
+
+```sh
+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](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](https://stevenlybeck.com/project-notebook/) —
+  diagrams and the why
+- [docs/architecture.md](docs/architecture.md) — the artifact pipeline,
+  plane by plane
+- [docs/security.md](docs/security.md) — three-plane access model (Unix
+  socket, LAN, loopback)
+- [docs/ios.md](docs/ios.md) — iOS app + share extension
+- [docs/development.md](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](PLAN.md) but not yet wired up.
+
+## License
+
+[MIT](LICENSE) © Steven Lybeck