commit 14445e7242c223e36ed41e42f02b9b7d4bbf693a
Author: Your Name <you@example.com>
Date:   Sat May 16 17:58:43 2026 -0400

    initial commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2a0258f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# Clio
+
+Multi-device encrypted audio recording system with transcription and search.
+
+## Repositories
+
+| Repo | Description |
+|------|-------------|
+| **clio-api** | FastAPI server - recordings, transcripts, highlights |
+| **clio-android** | Android app - continuous encrypted recording |
+| **clio-ui** | React frontend - viewer, search, highlights |
+| **clio-ai** | ML/AI - Whisper transcription, wake word detection |
+| **clio-infra** | Deployment configs, NixOS modules, docs |
+
+## Quick Start
+
+```bash
+# API server (dev)
+cd clio-api && uv run python main.py
+
+# UI (dev)
+cd clio-ui && python -m http.server 3000
+# Open http://localhost:3000/RecordingsViewer.html
+
+# Deploy to server
+cd clio-infra/scripts && ./deploy.sh
+```
+
+## Architecture
+
+See [clio-infra/ARCHITECTURE.md](clio-infra/ARCHITECTURE.md)
+
+## TODO
+
+See [clio-infra/TODO.md](clio-infra/TODO.md)
+
+## Hosts
+
+- **Server** (10.0.0.45): Storage, API, UI, Forgejo
+- **Desktop** (10.0.0.130): GPU transcription, real-time detection
+- **Phone**: Recording source (Android)
+- **Pi**: Portable recording source (TBD)