# 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/architecture.md)
- [docs/api-contract.md](docs/api-contract.md)
- [docs/system-map.md](docs/system-map.md)
- [SECURITY.md](SECURITY.md)

Draft shared types live in [packages/shared/src/types.ts](packages/shared/src/types.ts).
Fake fixtures live in [packages/fixtures/fixtures.v0.json](packages/fixtures/fixtures.v0.json).

## License

MIT