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

Related MCP server: second-brain-cloudflare

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