An agent-friendly notes app that syncs to a folder of plain markdown files.

Kladde is Danish for draft and sounds kind of like Clawd if you squint hard enough.

kladde running on iPhone — editing a note with checklists and markdown formatting
📁

Plain markdown files

.md files in a directory. Cat, grep, git — they're yours.

🤖

Agent-friendly

AI reads and writes notes on the filesystem. Plain files, zero friction.

🔌

REST API

Search, read, write and find-and-replace over HTTP. Bearer token auth. Self-documenting at /api.

📱

Offline-first PWA

IndexedDB cache, background sync with retry. Works offline.

Instant two-way sync

Phone ↔ disk. WebSocket-powered.

✏️

Rich markdown editor

Rich toolbar or raw markdown. Checklists, tables, blockquotes.

🔍

Search and star

Filter by title and content. Star to pin. Organize with collections.

🔗

Share with a link

Share any note as a public link — read-only or editable. No sign-up required.

🔒

Self-hosted

Single Go binary, zero deps. Your notes stay on your machine.

💾

Git backup

Optional auto commit + push to a remote. Built-in.

📐

Responsive

Optimized for mobile, desktop and tablet.

🌙

Dark mode

Follows system preference. Warm dark, clean light.

Get the beta

Releases are coming. For now, ask your agent to install from the git repo.

GitHub →

Tech stack

Server: Go. Watches the notes folder with fsnotify, syncs over WebSocket, serves the client.

Client: Vue 3 + TypeScript PWA. Tiptap for rich editing, Pinia for state, Workbox for offline.