OpenSource-Hub

files.md

Application

zakirullin/files.md

Private, local-first note-taking app for markdown files.

Overview

A local-first, private note-taking application that stores everything in plain .md files. It offers chat-like capture, journaling, task lists, and works offline. The codebase is simple and designed to be extended by LLMs.

README Preview

\n\n# Files.md  \nPrivate, quiet space for thinking. A simple app for your `.md` files.  \n\n\n\nYou can store your whole life:\n- 📌 Notes\n- 📝 Documents, Projects\n- 💚 Journal, Habits\n- ✅ Checklists, Tasks\n\nAll in plain `.md` files, local-first. LLM-friendly. **Private - no data is sent to server**.    \n\n> Own your data as plain local files.  \n> Own the software that opens those files.  \n> Grow your knowledge with files and your own brain.  \n> Grow the software around it with an LLM.  \n> **Plain files and self-owned software can last through the ages**.  \n \nTry it out: [app.files.md](https://app.files.md) (Beta). Main site: [files.md](https://files.md).\n\n**I have been building this project for 5 years**. Consider **[supporting on GitHub 💚](https://github.com/sponsors/zakirullin)**.  \n\nYou can use this app for Zettelkasten, Second Brain, Notes taking, Journaling, To Do lists, Checklists, and more.  \n\n[Dump your thoughts](#dump-your-thoughts) · [How to think deeply](#how-to-think-deeply) · [Second Brain?](#second-brain) · [Journal, tasks and checklists](#journal) · [Files structure](#files-structure)\n\n## Another note taking app? \nMaybe. But this time:\n- Only necessary features, **restrictions foster creativity**\n- **Chat-like flow for lazy thought capture**\n- Free and open source\n- No need to install anything, all you need is a browser\n- Works offline\n- **Local-first, files don't leave your device**\n- Extremely simple code. **One person or an LLM can fit the whole project in head**\n- The codebase is ready for your LLM to extend to your needs\n- Portable, no build systems, just open `web/index.html` \n- Optional out of the box synchronization \n- The server is just one binary (or use iCloud/Dropbox/Google Drive for sync)\n- Telegram chatbot for on-the-go access to your files\n\n## How to use\n- Open [app.files.md](https://app.files.md) (Chrome is recommended)\n- Click "Install files.md" on the right side of the address bar:\n\n    \n  \

FAQ (1)

Troubleshooting
Does this app support opening local folders in Firefox?

The app works in Firefox for operations using OPFS (Origin Private File System) for browser local storage. However, opening local folders requires the File System Access API, which is not yet fully supported by Firefox. As a workaround, use Chromium-based browsers like Chrome or Edge for local folder access. Monitor Firefox's implementation status at caniuse.com/native-filesystem-api.

GitHub Issue #34