{"slug": "open-source-reflect-rewrite", "title": "Open-Source Reflect Rewrite", "summary": "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.", "body_md": "Plain-file notes for Mac and iPhone: daily notes, wiki links, local search, and optional AI over your own Markdown.\n\nReflect is an open-source note-taking app built around a folder of Markdown\nfiles. It opens to today's note, lets `[[wiki links]]`\n\nconnect people,\nprojects, and ideas, and keeps search and backlinks fast without turning your\nnotes into an app-only database.\n\nThe 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.\n\n**Daily notes:** the app opens to today's note, and capture defaults there.**Wiki links and backlinks:** type`[[`\n\nto link notes; each note shows what links back to it.**Local search:**`⌘K`\n\nsearches notes, backlinks, and tags. Optional semantic search can be enabled locally.**Ask your notes:**`⌘J`\n\ncan query notes through user-provided OpenAI, Anthropic, Google, or OpenRouter keys. Answers cite source notes.**Private notes:**`private: true`\n\nexcludes 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`\n\n,`reflect search`\n\n, and`reflect show`\n\nare available for scripts and agents. See[docs/cli.md](/team-reflect/reflect-open/blob/next/docs/cli.md).\n\n-\n**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)\n\nEach build is signed, notarized, and auto-updated from GitHub Releases. You can also\n\n[view all releases](https://github.com/team-reflect/reflect-open/releases). -\n**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. -\n**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.\n\nYou can also [build from source](#building-from-source).\n\nSee [CHANGELOG.md](/team-reflect/reflect-open/blob/next/CHANGELOG.md) for release notes.\n\nReflect calls a notes folder a **graph**. A graph is a folder you can inspect,\nback up, sync, or edit with other tools:\n\n```\nmy-graph/\n├── daily/2026-06-12.md     # Daily notes, named by date\n├── notes/some-title.md     # Other notes, named from their titles\n├── assets/                 # Images and attachments\n└── audio-memos/            # Audio recordings and transcripts\n```\n\nMarkdown 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.\n\nFor simple file sync across Apple devices, create your graph inside an\niCloud-synced folder such as `iCloud Drive/ReflectGraph`\n\n.\n\nFor versioned backup or non-iCloud sync, connect GitHub in the app or add\n[any SSH git remote](/team-reflect/reflect-open/blob/next/docs/generic-git-remotes.md). Git sync stores the Markdown\ngraph in a repository you control.\n\nBy default, note content stays on the device. External calls only happen after\nyou configure a provider, connect a git remote, or use a platform sync service.\nSee [docs/privacy.md](/team-reflect/reflect-open/blob/next/docs/privacy.md) for the full privacy model.\n\nPrerequisites:\n\n- A recent stable\n[Rust toolchain](https://rustup.rs) - Node.js with\n[pnpm](https://pnpm.io)10 - Xcode Command Line Tools\n\n```\ngit clone https://github.com/team-reflect/reflect-open.git\ncd reflect-open\ncorepack enable\npnpm install\npnpm tauri dev\npnpm tauri build\n```\n\nReflect is a pnpm/Turborepo monorepo:\n\n```\nreflect-open/\n├── apps/desktop/          # Mac and iOS app\n├── apps/cli/              # `reflect` CLI\n├── apps/extension/        # Chrome capture extension\n├── apps/native-host/      # Browser capture helper\n├── packages/core/         # Shared TypeScript logic\n├── packages/db/           # Database types and helpers\n├── crates/index-schema/   # Shared index schema\n├── design-system/         # Tokens and UI primitives\n└── docs/                  # Product, architecture, and contributor docs\n```\n\nSee [CONTRIBUTING.md](/team-reflect/reflect-open/blob/next/CONTRIBUTING.md), [docs/contributing/](/team-reflect/reflect-open/blob/next/docs/contributing),\nand [AGENTS.md](/team-reflect/reflect-open/blob/next/AGENTS.md) for conventions and development guides.\n\nCommon commands from the repository root:\n\n```\npnpm dev              # Vite only, http://localhost:1420\npnpm typecheck        # TypeScript\npnpm lint             # oxlint\npnpm test             # vitest; use --run path/to/test for one file\npnpm check            # typecheck + lint\n\n# Rust tests that compile the desktop crate need sidecars staged first\npnpm --filter @reflect/desktop sidecar\ncargo test --workspace\n```\n\nFor iOS simulator development:\n\n```\npnpm tauri:ios:dev \"iPhone 17 Pro\"\n```\n\nFor TestFlight builds:\n\n```\npnpm release:ios preflight --build-number=123\npnpm release:ios testflight --build-number=123 --wait\n```\n\nReflect is in beta and used daily. The current focus is the Mac app, iOS companion, browser capture, local-first data model, and sync reliability.\n\nWindows, Android, and a plugin API are out of scope for now. See the\n[V2 product vision](/team-reflect/reflect-open/blob/next/docs/reflect-v2-product-vision.md) and the implementation\nplans in [docs/plans/](/team-reflect/reflect-open/blob/next/docs/plans) for the longer-term direction.\n\n[MIT](/team-reflect/reflect-open/blob/next/LICENSE).", "url": "https://wpnews.pro/news/open-source-reflect-rewrite", "canonical_source": "https://github.com/team-reflect/reflect-open", "published_at": "2026-07-14 12:09:09+00:00", "updated_at": "2026-07-14 12:19:21.472052+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools"], "entities": ["Reflect", "OpenAI", "Anthropic", "Google", "OpenRouter", "GitHub", "iCloud", "Chrome"], "alternates": {"html": "https://wpnews.pro/news/open-source-reflect-rewrite", "markdown": "https://wpnews.pro/news/open-source-reflect-rewrite.md", "text": "https://wpnews.pro/news/open-source-reflect-rewrite.txt", "jsonld": "https://wpnews.pro/news/open-source-reflect-rewrite.jsonld"}}