🌸 TagMesh

Zero-Folder · Titleless · Tag-Woven Markdown Notes System with Claymorphic Aesthetics & Serverless Edge

Ditch folders and titles. Weave thoughts organically through #hashtags at the edge.

🇬🇧 English • 🇨🇳 简体中文

✨ Key Features

• 🏷️ Zero Titles & Zero Folders: Treat notes as fluid Markdown streams. Categorization relies purely on #hashtags with automatic first-line excerpt summaries.

• 🎨 Tactile Claymorphism Aesthetics: Rounded clay pills, spatial relief shadows, auditory soundscapes, particle bursts, and 6 curated mood themes.

• 💬 Cross-Device Shared Danmaku Plaza: Thoughts sent from mobile fly across desktop monitors in real time with synchronized reaction hearts and authoritative telemetry.

• 🧭 6 Multi-Dimensional Galleries: Bento Grid, 3D Spatial Carousel, Galaxy Mesh Graph, Polaroid Board, Timeline Stream, and Freeform Canvas.

• 🤖 Native Serverless MCP Interface: Edge-native Model Context Protocol (JSON-RPC 2.0) interface with 8 production tools ready for Claude Desktop and Cursor.

Related MCP server: ai-journal

⚡ Essential Shortcuts

🚀 Quick Local Development

# 1. Clone repo & install dependencies
git clone https://github.com/SaulGoodManC99/TagMesh.git
cd TagMesh
npm install

# 2. Start frontend dev server (with LAN access on 0.0.0.0:5173)
npm run dev

# 3. Start Cloudflare Worker backend locally
npm run worker:dev

☁️ Cloudflare Deployment Guide

TagMesh runs on Cloudflare Workers + D1 SQLite Database:

1. Create D1 Database

Go to Cloudflare Dashboard -> D1 SQL Database -> Create database (name it tagmesh-db), copy your Database ID, and paste the contents of schema.sql into its Console to initialize tables.

2. Configure GitHub Actions Auto-Deployment (Recommended)

Add 3 secrets in your GitHub repo Settings -> Secrets and variables -> Actions:

• CLOUDFLARE_API_TOKEN: Cloudflare API Token

• CLOUDFLARE_ACCOUNT_ID: Cloudflare Account ID

• CLOUDFLARE_D1_DATABASE_ID: D1 Database ID from Step 1

Every git push to main now automatically builds and deploys to Cloudflare Edge in ~30 seconds!

3. Local CLI Deployment (Optional)

npx wrangler login
npm run db:init:remote
npm run build
npm run worker:deploy

🤖 MCP (Model Context Protocol) Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "tagmesh": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://your-domain.com/mcp"
      ]
    }
  }
}

Available tools: search_by_tag, search_fulltext, read_note, create_or_update_note, append_to_note, delete_note, list_tags, get_workspace_stats.

📄 License

Distributed under the MIT License.

Crafted with 💖 and Clay Magic by SaulGoodManC99