Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

tianma-if/edgeever

Productivity

Open-source, self-hostable note-taking workspace with three-pane editing, instant sync, web clipper and MCP for AI agents.

3,432
1,787
TypeScript
AGPL-3.0
4 months old

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

  1. laurent22/joplinA Markdown note-taking and to-do app with cross-platform clients and sync you can point at your own storage.TypeScript56,877
  2. jessepinkman9900/claude-second-brainScaffolds a Claude Code–maintained Obsidian wiki with local hybrid search and Git sync for personal knowledge management.JavaScript166
  3. Timaga/noda-local-ai-notesWindows local-first Markdown note app with knowledge graph, semantic search and cited-source chat.JavaScript105
  4. Ciao1019/ArcMDA native Go Markdown rich-text editor with local .md files, colorful spaces, and split views for note takers.Go218
  5. TriliumNext/TriliumA self-hosted, local-first notes app for people building a deeply linked personal knowledge base that they control.TypeScript38,542