explaingit

codexu/note-gen

11,835TypeScriptAudience · writerComplexity · 2/5Setup · easy

TLDR

A free, open-source note-taking app that stores your notes as plain Markdown files and adds AI tools for writing, organizing, and searching your thoughts, available on all major platforms.

Mindmap

mindmap
  root((NoteGen))
    What it does
      Quick capture area
      Markdown editor
      AI chat assistant
    Features
      Vector knowledge base
      Hybrid search
      Image capture
      Agent workflows
    Sync targets
      GitHub
      S3
      WebDAV
    Platforms
      Windows
      macOS
      Linux
      Mobile alpha
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Capture quick thoughts, screenshots, and links in a scratch area, then refine them into structured Markdown notes at your own pace.

USE CASE 2

Ask an AI assistant questions about your own past notes using a built-in knowledge base with vector search.

USE CASE 3

Sync your Markdown notes across devices via GitHub, GitLab, S3, or WebDAV without locking data into a proprietary format.

Tech stack

TypeScript

Getting it running

Difficulty · easy Time to first run · 5min

AI features require configuring your own model API key or a local model endpoint.

In plain English

NoteGen is a free, open-source note-taking app that stores your notes as plain Markdown files and adds AI tools to help you write, organize, and search through them. It is designed for the messy, early stage of thinking, where you want to capture something quickly without worrying about where it belongs or how it reads. The app is organized around three connected spaces. The first is a recording area where you drop in scattered thoughts, screenshots, links, and temporary clips without interrupting your flow. The second is a Markdown editor where you refine everything into structured notes, with support for tables, diagrams, math, and export options. The third is an AI chat window where you can ask questions about your notes, rewrite passages, translate content, or let the AI help reorganize what you have written. NoteGen supports a variety of AI model configurations, including custom models, custom prompts, saved memories, and agent workflows. It also includes a built-in knowledge base with vector indexing and hybrid search, so the AI can reference your past notes when answering questions. Images can be captured, described, and hosted directly within the app. Notes are stored as local Markdown files, which means they are readable by any text editor and not locked to the app. Syncing is available through GitHub, GitLab, Gitee, Gitea, S3, and WebDAV. The app runs on Windows, macOS, Linux, Android, and iOS, though the mobile versions are still in alpha. Desktop builds are in beta.

Copy-paste prompts

Prompt 1
I use NoteGen to store my notes. Help me write a reusable prompt template I can save in NoteGen's AI chat to automatically summarize and tag any new note I paste in.
Prompt 2
I want to set up NoteGen to sync my notes to an S3 bucket. Walk me through the sync configuration and what folder structure NoteGen uses for its Markdown files.
Prompt 3
Using NoteGen's AI knowledge base, how do I make the AI reference my past notes when answering questions? What is the vector indexing process and how do I trigger a re-index?
Prompt 4
I have hundreds of existing Markdown notes in a local folder. How do I import them into NoteGen while preserving the folder hierarchy?
Open on GitHub → Explain another repo

← codexu on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.