diff --git a/.gitignore b/.gitignore
index 4c805a9d..ac1f9a9e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -37,3 +37,4 @@ artifacts/perf/
 .superpowers/
 .opencode/
 sdk.session.snapshot
+.kata.local.toml
diff --git a/.kata.toml b/.kata.toml
new file mode 100644
index 00000000..873f0508
--- /dev/null
+++ b/.kata.toml
@@ -0,0 +1,4 @@
+version = 1
+
+[project]
+name = "freshell"
diff --git a/AGENTS.md b/AGENTS.md
index 2895354b..f483dfbf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -30,6 +30,9 @@ Freshell is a self-hosted, browser-accessible terminal multiplexer and session o
 - Use `npm run test:vitest -- ...` for a repo-owned direct Vitest path. Raw `npx vitest` is not a coordinated workflow.
 - `test:unit` is the exact default-config `test/unit` workload, `test:integration` is the exact server-config `test/server` workload, and `test:server` stays watch-capable unless you pass an explicit broad `--run`.
 
+## Kata
+- `.kata.toml` is committed project configuration. Always commit it after modifying it.
+
 ## Branch Model And Self-Hosting (CRITICAL - Read This)
 
 **This checkout is self-hosted from local `dev`, not local `main`.**