explaingit

team-reflect/reflect-open

Analysis updated 2026-05-18

1,339TypeScriptAudience · generalComplexity · 3/5LicenseSetup · easy

TLDR

A local-first Markdown note-taking app for Mac and iPhone with wiki-style links, optional AI over your own notes, and no proprietary file format.

Mindmap

mindmap
  root((Reflect))
    What it does
      Markdown note-taking
      Wiki links
      Local search
    Tech stack
      TypeScript
      Rust
      Tauri
    Use cases
      Daily notes
      AI queries over notes
      Cross-device sync
    Audience
      General note-takers
    Setup
      Mac installer
      iOS TestFlight
      Build from source

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep daily notes and link related ideas together with wiki-style backlinks.

USE CASE 2

Ask questions about your own notes using an AI provider you connect yourself.

USE CASE 3

Sync a plain-text notes folder across Mac and iPhone via iCloud or git.

What is it built with?

TypeScriptRustTauripnpmTurborepo

How does it compare?

team-reflect/reflect-openbookorbit/bookorbitggml-org/llama.vscode
Stars1,3391,3441,355
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-03
MaintenanceActive
Setup difficultyeasymoderatemoderate
Complexity3/54/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Prebuilt Mac installers work immediately, building from source needs Rust, Node.js with pnpm, and Xcode Command Line Tools.

Use, copy, modify, and share this freely, including for commercial purposes, as long as you keep the original copyright notice.

In plain English

Reflect is a note-taking app for Mac and iPhone built around a plain folder of Markdown files instead of a proprietary database. It opens straight to today's note, lets you connect ideas by typing double brackets around a word to create a link to another note, and shows you which notes link back to any given one. Everything you write stays as ordinary text files you could open and edit in any other Markdown editor, so you are never locked into the app. Beyond basic note taking, Reflect includes local search across your notes, backlinks, and tags, with an optional semantic search you can turn on. You can ask questions about your own notes using an AI model, but only after you connect your own API key from a provider like OpenAI, Anthropic, Google, or OpenRouter, and any note marked private is excluded from those AI calls. Other features include recording audio memos that get transcribed into your daily note, a Chrome extension for saving links and page content, and a command line tool that lets scripts or automated agents read and search your notes. Your notes folder, called a graph, can be synced between devices using iCloud Drive, or backed up with version history using GitHub or another git remote you control. By default, nothing about your notes leaves your device unless you specifically set up one of these external connections. Building Reflect from source requires a recent Rust toolchain, Node.js with the pnpm package manager, and Xcode Command Line Tools, since the project is a monorepo combining a Rust-based desktop app shell with TypeScript application code. Prebuilt Mac installers are available directly from GitHub releases, and an iOS version is available through Apple's TestFlight beta program. The project is currently in beta, focused on the Mac and iOS apps, with Windows and Android support explicitly out of scope for now. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up Reflect's daily notes and wiki links for the first time.
Prompt 2
Explain how Reflect keeps my notes private when using its AI query feature.
Prompt 3
Walk me through building Reflect from source with Rust and pnpm.
Prompt 4
Show me how to use the Reflect CLI to search my notes from a script.

Frequently asked questions

What is reflect-open?

A local-first Markdown note-taking app for Mac and iPhone with wiki-style links, optional AI over your own notes, and no proprietary file format.

What language is reflect-open written in?

Mainly TypeScript. The stack also includes TypeScript, Rust, Tauri.

What license does reflect-open use?

Use, copy, modify, and share this freely, including for commercial purposes, as long as you keep the original copyright notice.

How hard is reflect-open to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is reflect-open for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.