Summary Reflect Open is a local-first, AI-agent-friendly Markdown note-taking app prioritizing data ownership and privacy. It enables users to manage daily notes, connect ideas via wiki links, and perform fast local searches, all within a folder of plain Markdown files. The benefit lies in a private, extensible knowledge base that can optionally leverage user-provided AI models without external data sharing.

How It Works The core "graph" is a folder of Markdown files, ensuring notes are accessible with any tool. Features include daily notes, bidirectional [[wiki links]], and robust local search (optional semantic). AI integration allows querying notes via user-provided API keys (OpenAI, Anthropic, Google, OpenRouter), with AI responses citing source Markdown. A private: true flag prevents AI processing of specific notes.

Quick Start & Requirements Install the signed Mac app from GitHub Releases (Apple silicon/Intel). An iOS beta is available via TestFlight. The Reflect Capture Chrome extension is on the Chrome Web Store. Building from source requires Rust, Node.js (pnpm), Xcode Command Line Tools, bash, and git. Clone the repo, run pnpm install, then pnpm tauri dev or pnpm tauri build. Links to releases, CLI docs (docs/cli.md), privacy details (docs/privacy.md), contribution guides, and release notes (CHANGELOG.md) are available within the repository.

Highlighted Details

• Local-First, Plain-File Markdown: Data is stored in user-controlled Markdown files, ensuring portability and interoperability.
• Optional AI Integration: Query notes using personal API keys (OpenAI, Anthropic, Google, OpenRouter); AI answers cite source notes.
• Flexible Sync: Use iCloud Drive for Apple device sync or Git (GitHub/any SSH remote) for versioned backup.
• CLI Tools: Includes reflect today, reflect search, reflect show for scripting and agents.
• Browser Capture: Chrome extension saves web content directly to the note graph.

Maintenance & Community The project is in beta, actively used daily, focusing on Mac/iOS apps, browser capture, local data model, and sync reliability. Contribution guidelines are available, but specific community channels are not detailed.

Licensing & Compatibility Licensed under the MIT license, permitting commercial use and integration into closed-source projects.

Limitations & Caveats Currently in beta. Windows, Android support, and a plugin API are out of scope. Development focus is on Mac/iOS apps and sync reliability.