How Caliu Works
What happens behind the screen, and how to build on it: where your notes live, how sync works, the API, and MCP.
- Caliu under the hoodThe big picture: your devices, Caliu's server, and how the pieces fit together.
- Where your notes liveA real database on every device, the same one on the server, and Markdown as the format underneath it all.
- Inside syncHow a change travels from one device to the rest: a queue, a change log, and a careful merge when two devices disagree.
- The serverWhat runs in the cloud: a small TypeScript service on Cloudflare's network that relays your changes and serves the API.
- Native apps, not a wrapperEach Caliu app is built with its own platform's tools, so it feels at home wherever you write.
- The editorsHow each app turns plain Markdown into the page you write on, using the text engine its platform was built around.
- API keysGenerate an API key in settings and use it as a Bearer token to call the Caliu API from scripts and tools.
- API documentationExplore the Caliu REST API through interactive docs and a machine-readable OpenAPI spec.
- MCP server for developersRun the Caliu MCP server locally with an API key, or point Claude Code, Cursor, and other tools at the remote one.