accounts and email

apps/macos-sync/README.md

@@ -11,7 +11,7 @@ A macOS menubar application for syncing and uploading files to a Cairnquire serv
 - **Auto Sync**: Watch a local folder and automatically sync markdown files to the server
 - **Drag & Drop Upload**: Drop files onto the upload zone to upload and copy the URL to clipboard
 - **Quick Upload**: Upload files via the menubar menu or popover
-- **Clipboard Notes**: Create new notes from clipboard content
+- **New Notes**: Create notes from clipboard content or a terminal `$EDITOR` buffer
 - **Upload Index**: View all uploaded files with timestamps
 - **Custom Icons**: Choose from 11 different SF Symbols for the menubar icon
 - **CLI Tool**: Command-line interface for one-off uploads and note creation
@@ -32,6 +32,19 @@ swift build
 swift run CairnquireSync
 ```
 
+For local development with Keychain access, sign the SwiftPM executable with a
+stable Apple Development identity and run the signed binary directly:
+
+```bash
+cd apps/macos-sync
+scripts/sign-dev.sh CairnquireSync
+.build/debug/CairnquireSync
+```
+
+The script uses the first valid `Apple Development` code-signing identity. To
+choose a specific identity, set `CAIRNQUIRE_CODESIGN_IDENTITY` to the certificate
+name or SHA-1 hash shown by `security find-identity -v -p codesigning`.
+
 Or open in Xcode:
 ```bash
 open Package.swift
@@ -54,10 +67,10 @@ You can run the built executable directly after building:
 ## Setup
 
 1. Start your Cairnquire server
-2. Create an API token from the web UI at `/account`
+2. Create an API token from the web UI at `/account/tokens/new`
 3. Open the app settings (click the menubar icon → Settings)
 4. Enter your server URL and API token
-5. Optionally configure a sync folder and default upload folder
+5. Optionally configure a sync folder, default upload folder, and New Note behavior
 
 ## Usage
 
@@ -75,7 +88,7 @@ You can run the built executable directly after building:
 - **Drop on Icon**: Drag files directly onto the menubar icon — it bounces, then uploads
 - **Sync Now**: Manually trigger a sync
 - **Upload File**: Select files to upload
-- **Create Note from Clipboard**: Create a new markdown note from clipboard text
+- **New Note**: Create a markdown note from clipboard text or open Terminal.app with `$EDITOR`, depending on Settings
 - **Drop Zone**: Open a drag-and-drop upload window
 - **View Uploads**: See all uploaded files with timestamps
 - **Change Icon**: Pick from 11 SF Symbols in Settings (default: `tray.circle.fill`)
@@ -90,7 +103,8 @@ swift run cairnquire-cli config \
   --server http://localhost:9000 \
   --token dev \
   --folder "$HOME/Documents/Cairnquire" \
-  --upload-folder Inbox
+  --upload-folder Inbox \
+  --new-note editor
 ```
 
 Run one bidirectional sync:
@@ -127,6 +141,12 @@ swift run cairnquire-cli help sync
 
 Readable uploads (`.md`, `.markdown`, `.txt`, `.html`, and `.htm`) are published as rendered documents. If the same inbox filename already exists, the app asks whether to keep both files, replace the existing document, or cancel. If identical attachment bytes were already uploaded, the app asks whether to copy the existing URL or cancel.
 
+When New Note is set to `Open Terminal $EDITOR`, the menubar action opens a
+temporary markdown buffer in Terminal.app. The app uploads the saved buffer
+after the editor exits. It uses `$EDITOR`, then `$VISUAL`, and falls back to
+`vi`. Configure GUI editor launchers to wait for the buffer to close, such as
+`EDITOR="code --wait"`.
+
 ## Configuration
 
 Configuration is stored in: