Open-Source Reflect Rewrite

Reflect, an open-source note-taking app for Mac and iPhone, launched with support for daily notes, wiki links, local search, and optional AI integration via user-provided API keys. The app stores notes as plain Markdown files in a user-chosen folder, syncs via iCloud or git, and offers features like audio transcription, browser capture, and a CLI. Reflect prioritizes privacy by keeping note content on-device unless external services are explicitly configured.

Plain-file notes for Mac and iPhone: daily notes, wiki links, local search, and optional AI over your own Markdown. Reflect is an open-source note-taking app built around a folder of Markdown files. It opens to today's note, lets wiki links connect people, projects, and ideas, and keeps search and backlinks fast without turning your notes into an app-only database. The app does not require a Reflect account. Notes live in a folder you choose, and optional services such as AI providers, transcription, iCloud, GitHub, or another git remote are connected directly by the user. Daily notes: the app opens to today's note, and capture defaults there. Wiki links and backlinks: type to link notes; each note shows what links back to it. Local search: ⌘K searches notes, backlinks, and tags. Optional semantic search can be enabled locally. Ask your notes: ⌘J can query notes through user-provided OpenAI, Anthropic, Google, or OpenRouter keys. Answers cite source notes. Private notes: private: true excludes a note's content from AI and other external services. Audio memos: record audio and transcribe it into the daily note with a configured transcription provider. Browser capture: save links, selected text, screenshots, and page text from Chrome. Sync choices: use iCloud Drive for file sync, or git/GitHub for versioned backup. CLI: reflect today , reflect search , and reflect show are available for scripts and agents. See docs/cli.md /team-reflect/reflect-open/blob/next/docs/cli.md . - Install the Mac app. Download the latest release for your Mac: Stable: Apple silicon M-series https://github.com/team-reflect/reflect-open/releases/latest/download/Reflect aarch64.dmg · Intel https://github.com/team-reflect/reflect-open/releases/latest/download/Reflect x86 64.dmg Beta: Apple silicon M-series https://github.com/team-reflect/reflect-open/releases/download/updater-beta/Reflect.Beta aarch64.dmg · Intel https://github.com/team-reflect/reflect-open/releases/download/updater-beta/Reflect.Beta x86 64.dmg Each build is signed, notarized, and auto-updated from GitHub Releases. You can also view all releases https://github.com/team-reflect/reflect-open/releases . - Install the iOS beta. Join TestFlight https://testflight.apple.com/join/j2eEz43d . The iOS app uses the same plain-file graph and sync options as the Mac app. - Install the Chrome extension. Add Reflect Capture from the Chrome Web Store https://chromewebstore.google.com/detail/reflect-capture/ccabifmooehighoonjeiololjfofkhkd to save the current page, selected text, screenshots, and optional page text from Chrome. You can also build from source building-from-source . See CHANGELOG.md /team-reflect/reflect-open/blob/next/CHANGELOG.md for release notes. Reflect calls a notes folder a graph . A graph is a folder you can inspect, back up, sync, or edit with other tools: my-graph/ ├── daily/2026-06-12.md Daily notes, named by date ├── notes/some-title.md Other notes, named from their titles ├── assets/ Images and attachments └── audio-memos/ Audio recordings and transcripts Markdown files are the source of truth. Reflect adds search, backlinks, tags, and related notes on top, but the files remain usable in any Markdown editor. For simple file sync across Apple devices, create your graph inside an iCloud-synced folder such as iCloud Drive/ReflectGraph . For versioned backup or non-iCloud sync, connect GitHub in the app or add any SSH git remote /team-reflect/reflect-open/blob/next/docs/generic-git-remotes.md . Git sync stores the Markdown graph in a repository you control. By default, note content stays on the device. External calls only happen after you configure a provider, connect a git remote, or use a platform sync service. See docs/privacy.md /team-reflect/reflect-open/blob/next/docs/privacy.md for the full privacy model. Prerequisites: - A recent stable Rust toolchain https://rustup.rs - Node.js with pnpm https://pnpm.io 10 - Xcode Command Line Tools git clone https://github.com/team-reflect/reflect-open.git cd reflect-open corepack enable pnpm install pnpm tauri dev pnpm tauri build Reflect is a pnpm/Turborepo monorepo: reflect-open/ ├── apps/desktop/ Mac and iOS app ├── apps/cli/ reflect CLI ├── apps/extension/ Chrome capture extension ├── apps/native-host/ Browser capture helper ├── packages/core/ Shared TypeScript logic ├── packages/db/ Database types and helpers ├── crates/index-schema/ Shared index schema ├── design-system/ Tokens and UI primitives └── docs/ Product, architecture, and contributor docs See CONTRIBUTING.md /team-reflect/reflect-open/blob/next/CONTRIBUTING.md , docs/contributing/ /team-reflect/reflect-open/blob/next/docs/contributing , and AGENTS.md /team-reflect/reflect-open/blob/next/AGENTS.md for conventions and development guides. Common commands from the repository root: pnpm dev Vite only, http://localhost:1420 pnpm typecheck TypeScript pnpm lint oxlint pnpm test vitest; use --run path/to/test for one file pnpm check typecheck + lint Rust tests that compile the desktop crate need sidecars staged first pnpm --filter @reflect/desktop sidecar cargo test --workspace For iOS simulator development: pnpm tauri:ios:dev "iPhone 17 Pro" For TestFlight builds: pnpm release:ios preflight --build-number=123 pnpm release:ios testflight --build-number=123 --wait Reflect is in beta and used daily. The current focus is the Mac app, iOS companion, browser capture, local-first data model, and sync reliability. Windows, Android, and a plugin API are out of scope for now. See the V2 product vision /team-reflect/reflect-open/blob/next/docs/reflect-v2-product-vision.md and the implementation plans in docs/plans/ /team-reflect/reflect-open/blob/next/docs/plans for the longer-term direction. MIT /team-reflect/reflect-open/blob/next/LICENSE .