diff --git a/.gemini/settings.json b/.gemini/settings.json
new file mode 100644
index 0000000..68337d3
--- /dev/null
+++ b/.gemini/settings.json
@@ -0,0 +1 @@
+{ "contextFileName": "AGENTS.md" }
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..68d0b25
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,8 @@
+## Installation
+
+This is a set of dotfiles and utilities for setting up my personal environment
+on POSIX-style environments. It is cloned from github and installed from the
+`install.sh` script.
+
+It mostly relies on symlinking dotfiles and other resources into the appropriate
+locations, bnut also installs dependencies in various ways.