diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..a37a803
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,25 @@
+# beaver-gateway - локальный dev. В проде переменные приходят из .env
+# стека beaver-agent (env_file), этот файл там не нужен.
+
+# Postgres из `make db` (профиль db в ../beaver-agent) или sqlite для быстрого старта
+DATABASE_URL=postgresql+psycopg://beaver:beaver@localhost:5432/beaver
+#DATABASE_URL=sqlite+aiosqlite:///./db.db
+
+# Admin UI
+ADMIN_USER=admin
+ADMIN_PASS=admin
+SESSION_SECRET=dev-only-change-me
+
+# Пользовательский config.py (агенты, MCP, фронтенды)
+CONFIG_PATH=../beaver-agent/config.py
+
+# Токены для Anthropic/MCP фронтендов без admin UI: name:value,name:value
+BOOTSTRAP_TOKENS=dev:dev-token-change-me
+
+# Claude: `claude setup-token` на маке
+CLAUDE_CODE_OAUTH_TOKEN=
+
+# Raycast (нужно только если в config.py есть RaycastAgent)
+RAYCAST_CONFIG_PATH=../raycast-api/config.json
+RAYCAST_DEVICE_ID=
+RAYCAST_BEARER=