From bf6de3b7acd38264675ced0f568ac0fc419b6422 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 5 Jan 2026 11:00:31 +0000
Subject: [PATCH] Add README.md with project overview and getting started guide

---
 README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6c26699
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Grimoire
+
+A Nostr protocol explorer and developer tool with a tiling window manager interface.
+
+## Features
+
+- **Tiling Windows** - Each window is a Nostr "app" (profile viewer, event feed, NIP docs, etc.)
+- **Command Palette** - Unix-style commands via `Cmd+K` to open apps and navigate
+- **Multi-workspace** - Virtual desktops with independent layouts
+- **Real-time** - Reactive event subscriptions with automatic updates
+- **Offline Support** - Event caching via IndexedDB
+
+## Stack
+
+React 19, TypeScript, Vite, TailwindCSS, Jotai, Dexie, Applesauce
+
+## Getting Started
+
+```bash
+npm install
+npm run dev
+```
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Start dev server |
+| `npm run build` | Build for production |
+| `npm test` | Run tests in watch mode |
+| `npm run lint` | Lint code |
+| `npm run format` | Format code |
+
+## License
+
+MIT