1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6eff2c4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# kitty-conf
+
+My [kitty](https://sw.kovidgoyal.net/kitty/) terminal configuration.
+
+- `kitty.conf`: main config
+- `session.conf`: startup session (tabs and layouts)
+- `current-theme.conf`: colours, generated by `udt-palette` from the
+  unified-desktop-theme project. Do not edit by hand.
+
+## Install
+
+Symlink the files into kitty's config dir:
+
+```sh
+for f in kitty.conf session.conf current-theme.conf; do
+    ln -sfn "$PWD/$f" ~/.config/kitty/$f
+done
+```
+
+## License
+
+GPLv2 only. See [LICENSE](LICENSE).
+
+## Development Approach
+
+This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback.
+
+All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions.
+
+The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.