SkyBrain

SkyBrain is a small personal memory and Markdown notes system for people who use AI tools as thinking partners.

It gives humans a fast writing surface and gives AI clients a shared MCP memory layer, backed by Cloudflare Workers and D1.

This project is intentionally single-user software. It is not a SaaS, not a team knowledge base, and not trying to replace Obsidian. The goal is a personal system that is easy to understand, easy to run, and honest about where the data lives.

What This Repo Will Contain

• Cloudflare Worker backend
• MCP tools for AI clients
• REST API for the browser app
• mobile-friendly Markdown writing UI
• D1 migrations
• fake demo fixtures
• Markdown export tooling
• setup and security docs

Public Code, Private Data

This repository is for public code and fake fixtures only.

Do not commit:

• real notes
• raw voice logs
• generated personal backups
• .env or .dev.vars
• Wrangler state
• bearer tokens
• OAuth secrets
• screenshots containing private notes

The private production deployment can use this code with private Cloudflare bindings, private secrets, and a private backup repo.

Status

Early planning/scaffold. The current private SkyBrain prototype still lives outside this repo.

See:

• docs/architecture.md
• docs/api-contract.md
• docs/system-map.md
• SECURITY.md

Draft shared types live in packages/shared/src/types.ts. Fake fixtures live in packages/fixtures/fixtures.v0.json.

License

MIT