reflect

# Reflect Notes Skill Reflect is a networked note-taking app. Notes are E2E encrypted, so the API is **append-only** — we can write but not read note contents. ## Setup 1. Create OAuth credentials at https://reflect.app/developer/oauth 2. Generate an access token from that interface 3. Set environment variables: ```bash export REFLECT_TOKEN="your-access-token" export REFLECT_GRAPH_ID="your-graph-id" # Find via: curl -H "Authorization: Bearer $REFLECT_TOKEN" https://reflect.app/api/graphs ``` Or store in 1Password and update `scripts/reflect.sh` with your vault/item path. ## What We Can Do 1. **Append to daily notes** — Add items to today's note (or a specific date) 2. **Create new notes** — Create standalone notes with subject + markdown content 3. **Create links** — Save bookmarks with highlights 4. **Get links/books** — Retrieve saved links and books ## API Reference Base URL: `https://reflect.app/api` Auth: `Authorization: Bearer <access_token>` ### Append to Daily Note ```bash curl -X PUT "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/daily-notes" \ -H "Authorization: Bearer $REFLECT_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "text": "Your text here", "transform_type": "list-append", "date": "2026-01-25", # optional, defaults to today "list_name": "[[List Name]]" # optional, append to specific list }' ``` ### Create a Note ```bash curl -X POST "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/notes" \ -H "Authorization: Bearer $REFLECT_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "subject": "Note Title", "content_markdown": "# Heading\n\nContent here...", "pinned": false }' ``` ### Create a Link ```bash curl -X POST "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/links" \ -H "Authorization: Bearer $REFLECT_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com", "title": "Page Title", "description": "Optional description", "highlights": ["Quote 1", "Quote 2"] }' ``` ### Get Links ```bash curl "https://reflect.app/api/graphs/$REFLECT_GRAPH_ID/links" \ -H "Authorization: Bearer $REFLECT_TOKEN" ``` ## Helper Script Use `scripts/reflect.sh` for common operations: ```bash # Append to daily note ./scripts/reflect.sh daily "Remember to review PR #6" # Append to specific list in daily note ./scripts/reflect.sh daily "Buy milk" "[[Shopping]]" # Create a new note ./scripts/reflect.sh note "Meeting Notes" "# Standup\n\n- Discussed X\n- Action item: Y" # Save a link ./scripts/reflect.sh link "https://example.com" "Example Site" "Great resource" ``` ## Use Cases - **Capture todos** from chat → append to daily note - **Save interesting links** mentioned in conversation - **Create meeting notes** or summaries - **Sync reminders** to Reflect for persistence - **Backlink to lists** like `[[Ideas]]` or `[[Project Name]]` ## Limitations - **Cannot read note contents** (E2E encrypted) - **Append-only** — can't edit or delete existing content - **No search** — can't query existing notes