Foam is a personal knowledge management system built on VS Code and GitHub for linking, navigating and publishing Markdown notes.
jsgrrchg/NeverWrite
A local-first markdown workspace where you write, manage notes, and run AI agents with explicit review of their edits.
Open-source alternative to:Obsidian
- Stars
- 794
- Forks
- 75
- Open issues
- 18
- Last commit
- 7 days ago
What is it?
NeverWrite is a desktop workspace for working with local Markdown vaults alongside multiple AI agents. It puts a Markdown-first editor, knowledge navigation, agent chat sessions, and change review in one multipane app, so notes and agent work stay in the same place.
The editor handles Markdown, Mermaid, CSV, text and code files, PDFs, images, and Excalidraw diagrams. Navigation covers wikilinks, backlinks, tags, advanced search, bookmarks, and 2D or 3D graph views. Agent sessions support Codex, Claude, Grok, Kilo, OpenCode, and Pi, with attachments and saved local transcripts.
AI-made edits are tracked and can be reviewed inline, in chat, or in a dedicated review tab, where whole files or individual hunks can be kept or rejected. A companion browser extension clips pages, selections, or URLs into the desktop app.
Key features
- 01Markdown, Mermaid, CSV, code, PDF, image, and Excalidraw editing in one workspace.
- 02Wikilinks, backlinks, tags, advanced search, and 2D or 3D graph views.
- 03Agent sessions with Codex, Claude, Grok, Kilo, OpenCode, and Pi.
- 04Tracked AI edits that can be kept or rejected per file or per hunk.
- 05Browser extension for clipping pages, selections, and URLs into the vault.
Use cases
- Keeping research notes and agent conversations in one local vault.
- Reviewing AI-suggested edits to documents before accepting them.
- Clipping web research directly into a Markdown knowledge base.
- Exploring linked notes through backlinks and graph views.
Quick start
- 1
Clone the repository
git clone https://github.com/jsgrrchg/NeverWrite.git - 2
Enter the desktop app directory
cd NeverWrite/apps/desktop - 3
Install dependencies
npm install - 4
Start the app in development mode
npm run dev
Things to know
- Requires Rust and Cargo, and the first start builds the native backend.
- Some AI agent providers need their own CLI login or API key.
- Pi agent support requires separately installing the Pi CLI.
In collections
Topics
FAQ
- What is NeverWrite?
- A local-first markdown workspace where you write, manage notes, and run AI agents with explicit review of their edits. NeverWrite is a desktop workspace for working with local Markdown vaults alongside multiple AI agents. It puts a Markdown-first editor, knowledge navigation, agent chat sessions, and change review in one multipane app, so notes and agent work stay in the same place.
- Is NeverWrite free to use? What license does it have?
- NeverWrite is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is NeverWrite still maintained?
- Actively maintained. The last commit to NeverWrite was on Oct 31, 2026.
- What can I use NeverWrite for?
- Keeping research notes and agent conversations in one local vault. Reviewing AI-suggested edits to documents before accepting them. Clipping web research directly into a Markdown knowledge base. Exploring linked notes through backlinks and graph views.
- How do I install NeverWrite?
- Clone the repository: git clone https://github.com/jsgrrchg/NeverWrite.git Enter the desktop app directory: cd NeverWrite/apps/desktop Install dependencies: npm install Start the app in development mode: npm run dev
- Where can I get NeverWrite?
- The source code and installation instructions are on GitHub: https://github.com/jsgrrchg/NeverWrite
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Markdown knowledge graph with an LSP for your editor and a CLI and MCP server so AI agents can read and write the same notes.
A privacy-first, open-source knowledge management app for outlining, linking and annotating notes in Markdown or Org-mode.
A free, open-source desktop and self-hosted note-taking app for building large hierarchical personal knowledge bases.
Desktop app for macOS, Windows, and Linux that manages a markdown knowledge base as plain files backed by git.
A local, private markdown editor with WYSIWYG editing and side-by-side AI editing through Claude, Codex and other agents via MCP and CLI.