diff --git a/.codex b/.codex
new file mode 100644
index 0000000..09180d5
--- /dev/null
+++ b/.codex
@@ -0,0 +1,12 @@
+AskKennyB project context
+
+- Site source is in `askkennyb/`
+- Static site generator is Hugo
+- Theme is vendored at `askkennyb/themes/PaperMod`
+- Local build command: `hugo --minify -s askkennyb`
+- Generated output is `askkennyb/public/`
+- `askkennyb/public/` is ignored in Git and should not be committed
+- Pushes to `main` trigger `.gitea/workflows/deploy.yml`
+- CI builds the site and deploys it to Cloudron Surfer
+- Git remote uses SSH on `code.askkb.com` port `29418`
+- Local tools expected: `git`, `ssh`, `hugo`, `rg`, `node`, `npm`, `surfer`