tianma-if/edgeever
ProductivityOpen-source, self-hostable note-taking workspace with three-pane editing, instant sync, web clipper and MCP for AI agents.
What EdgeEver does
EdgeEver is an open-source notes and personal knowledge base workspace that keeps the classic three-pane layout (notebook tree, note list, editor) while adding markdown/rich-text switching, tables, Mermaid diagrams, mind maps and poster notes. It targets people who want cloud-style instant sync across devices without a paid subscription, and who want their data in a portable format they can self-host. Web, macOS, Windows, Linux, iOS and Android clients are provided, plus a browser clipper for Chrome, Edge and Firefox All-platform clients.
The backend is a single Hono/Zod application that can run on Cloudflare Workers with D1/R2 or as a Docker container with SQLite and local or S3-compatible storage. A remote MCP endpoint lets AI agents such as Claude Code or Codex read and write notes, notebooks, tags and attachments within account permissions MCP guide.
Try it before deploying
A public demo is available at demo.edgeever.org; it resets daily at 03:00 China Standard Time, so do not store private content there. To run your own copy locally for development, install Bun and run:
bun install
bun run dev
Local development signs in automatically; a fresh database uses owner / edgeever-local-dev. Log out if you need to test the login screen README quick start.
Deployment options
Cloudflare is the recommended zero-server route: fork the repository, create the D1 and R2 resources, create a Worker, set EDGE_EVER_AUTH_PASSWORD as a Secret before connecting the fork, then trigger the Update deployed EdgeEver GitHub Actions workflow and confirm /api/health and /api/openapi.json respond. A copy-paste prompt for delegating these steps to an AI agent is in the README agent deployment, with a manual seven-step version in the online deployment guide.
For a VPS, NAS or home server, the Docker path keeps the same frontend, API, MCP implementation and migrations but uses SQLite plus local or S3-compatible attachments; images support amd64 and arm64 Docker guide. The README offers a hosted installer:
curl -fsSL https://edgeever.org/install.sh | bash
It pulls the GHCR image, generates an administrator password and starts the stack with Docker Compose; updates then run daily by default and can be triggered manually with ~/edgeever/update.sh.
Using the workspace
After deployment, sign in as admin with the password you set, or as owner locally. Create notebooks and notes, attach files up to 1 GiB with client-side image compression, and use the web clipper or mobile share sheet to capture content. Backup and migration live under Profile → Import and export: a ZIP preserves structured metadata and the extracted notes/ directory keeps plain Markdown and attachments. One-click GUI imports cover flomo, Evernote, Obsidian and Joplin, while other platforms are handled through the MCP/agent route described in the migration guide.
For AI use, create a token under Profile → API / MCP and paste the remote MCP configuration into your agent client. The instance administrator can create or disable member accounts, each with an isolated workspace and storage dashboard.
Constraints
- The Cloudflare free tier is the advertised zero-cost path, but R2 requires activating a subscription and adding a payment method before the free allowance applies Cloudflare R2 notes.
- The iOS app needs an Apple ID from outside mainland China.
- Docker storage and the optional S3/OSS or image-host configuration must be set up separately; changing storage does not migrate existing attachments.
- Built-in 2FA, brute-force protection and tenant isolation are described, but deployments are self-managed: the maintainers do not host or review user content outside the official demo README disclaimer.
- The project is AGPL-3.0; forks may state they are based on EdgeEver but must not imply official status.
HotRepo's take
On the 2026-11-19 daily TypeScript list EdgeEver ranked 8th with 57 stars gained that day, against a total of 3,427 stars and 1,779 forks. That fork-to-star ratio is unusual and fits a product whose README is built around fork-and-deploy on Cloudflare: many users likely fork it as a deployment step rather than as a contribution. There is no all-language daily rank recorded, so the TypeScript-list position is the only ranking evidence available here, and a single snapshot does not establish a trend. The project's differentiation lies in pairing a conventional three-pane note app with a native MCP endpoint and two deployment targets sharing one codebase, which makes it worth evaluating for self-hosters who want agent access to their notes without a hosted subscription.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- laurent22/joplinA Markdown note-taking and to-do app with cross-platform clients and sync you can point at your own storage.
- jessepinkman9900/claude-second-brainScaffolds a Claude Code–maintained Obsidian wiki with local hybrid search and Git sync for personal knowledge management.
- Timaga/noda-local-ai-notesWindows local-first Markdown note app with knowledge graph, semantic search and cited-source chat.
- Ciao1019/ArcMDA native Go Markdown rich-text editor with local .md files, colorful spaces, and split views for note takers.
- TriliumNext/TriliumA self-hosted, local-first notes app for people building a deeply linked personal knowledge base that they control.