docs: add comprehensive README with features, usage, and motivation

Assisted-by: Claude Code
Signed-off-by: Avinal Kumar <avinal.xlvii@gmail.com>

README.md

@@ -1,2 +1,64 @@
-# sciezka
+# Sciezka
-A browser extension for fuzzy searching tabs, history and bookmarks.
+
+A fast, Spotlight-style browser extension for searching tabs, history, bookmarks, and recently closed tabs. Built with vanilla TypeScript — no framework dependencies.
+
+*Sciezka* means "path" in Polish.
+
+## Why?
+
+I relied on [Saka](https://github.com/lusakasa/saka) for years to quickly jump between tabs, search history, and find bookmarks — all from the keyboard. It stopped being maintained. I couldn't find a replacement that was as fast and keyboard-driven, so I built one.
+
+## Features
+
+- **Fuzzy search** across open tabs, browsing history, bookmarks, and recently closed tabs
+- **Three search methods**: fuzzy (fzy algorithm), full-text, and prefix matching
+- **Keyboard-driven**: navigate entirely with keyboard shortcuts
+- **Spotlight-style overlay**: appears on any page without leaving your current context
+- **Match highlighting**: matched characters highlighted in search results
+- **Configurable**: set default search method and mode order via the options page
+
+### From source
+
+```bash
+git clone https://github.com/avinal/sciezka.git
+cd sciezka
+```
+
+Load as a temporary extension in Firefox: `about:debugging` > This Firefox > Load Temporary Add-on > select `manifest.json`.
+
+## Usage
+
+Press **Ctrl+Space** to open the search overlay on any page.
+
+| Key | Action |
+|---|---|
+| `Ctrl+Space` | Toggle open/close |
+| `Esc` | Close |
+| `Up/Down` | Navigate results |
+| `Enter` | Open selected result |
+| `Ctrl+Shift+Enter` | Open in new tab |
+| `Tab` / `Shift+Tab` | Cycle through modes |
+| `Ctrl+F` | Cycle search method (fuzzy / full-text / prefix) |
+| `Ctrl+D` | Close selected tab (Tabs mode only) |
+
+### Modes
+
+- **Tabs** — open tabs in all windows
+- **History** — browsing history
+- **Bookmarks** — saved bookmarks
+- **Closed** — recently closed tabs
+
+## Building
+
+```bash
+npm run build    # one-time build
+npm run watch    # rebuild on file changes
+```
+
+## License
+
+MIT
+
+## Disclaimer
+
+I have no practical knowledge of working with TypeScript or Mozilla Extensions. I created this extention mostly using Claude because the one I was using is not longer maintained. I hope to maintain this for long time. If you find any issues/concerns please feel free to contact me or open an issue.