diff --git a/README.md b/README.md
new file mode 100644
index 0000000..37ab6f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# Task Warrior GPUI
+
+![Task Warrior GPUI Screenshot](docs/task-warrior-gpui.png)
+
+A desktop GUI for [TaskWarrior](https://taskwarrior.org/) built with [GPUI](https://gpui.rs/), the GPU-accelerated UI framework from Zed.
+
+## Features
+
+- View and filter tasks by project, status, priority, and due date
+- Project tree with task counts
+- Tag filtering with multi-select
+- Sortable task table with pagination
+- Dark theme (Ayu-inspired)
+
+## Requirements
+
+- Rust 2024 edition
+- TaskWarrior
+
+## Build
+
+```bash
+cargo build --release
+```
+
+## Run
+
+```bash
+cargo run
+```
+
+## License
+
+MIT OR Apache-2.0
diff --git a/docs/task-warrior-gpui.png b/docs/task-warrior-gpui.png
new file mode 100644
index 0000000..521268a
Binary files /dev/null and b/docs/task-warrior-gpui.png differ