# Lightwrite

> AI-first, local-first notetaking over plain files you own. Docs are .md, boards are .json, pages are .html, all in a folder you control. Ships the `nekko` CLI and the `lightwrite-mcp` MCP server so AI agents use your vault as durable memory and a RAG corpus. MIT licensed.

## Docs
- [Getting Started](https://github.com/nekko-labs/lightwrite/blob/main/docs/getting-started.md): install, first vault, live demo, importing notes
- [CLI Reference](https://github.com/nekko-labs/lightwrite/blob/main/docs/cli.md): every nekko command with examples
- [MCP Server](https://github.com/nekko-labs/lightwrite/blob/main/docs/mcp.md): lightwrite-mcp setup, tools, and agent recipes
- [Vault Format](https://github.com/nekko-labs/lightwrite/blob/main/docs/vault-format.md): the on-disk layout and front-matter schema
- [Self-Hosting](https://github.com/nekko-labs/lightwrite/blob/main/docs/self-hosting.md): run the sync server with Docker
- [Views and Lenses](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/lenses.md): the layout-preserving gather (signature feature)
- [Canvas Guide](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/canvas.md): infinite canvas, sections, connectors, drawing
- [Tasks and Kanban](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/tasks-kanban.md): boards, fields, view options
- [HTML Wiki](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/html-wiki.md): publish AI artifacts as real pages
- [Collaboration and Sharing](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/collaboration-sharing.md): collaborators, roles, share dialog, live editing
- [Voice and AI](https://github.com/nekko-labs/lightwrite/blob/main/docs/guides/voice-and-ai.md): assistant, local models, Apple Intelligence

## Optional
- [README](https://github.com/nekko-labs/lightwrite/blob/main/README.md): project overview and quick start
- [Telemetry](https://github.com/nekko-labs/lightwrite/blob/main/TELEMETRY.md): every analytics event, verbatim
- [Contributing](https://github.com/nekko-labs/lightwrite/blob/main/CONTRIBUTING.md): the upstream-contribution model
- [Live demo](https://nekko-labs.github.io/lightwrite/app/): the real app, seeded, no account