diff --git a/.codex/environments/environment.toml b/.codex/environments/environment.toml
new file mode 100644
index 000000000..6d0846424
--- /dev/null
+++ b/.codex/environments/environment.toml
@@ -0,0 +1,37 @@
+# THIS IS AUTOGENERATED. DO NOT EDIT MANUALLY
+version = 1
+name = "Folo"
+
+[setup]
+script = '''
+pnpm i
+'''
+
+[[actions]]
+name = "web dev"
+icon = "run"
+command = "pnpm dev:web"
+
+[[actions]]
+name = "electron dev"
+icon = "run"
+command = '''
+cd apps/desktop
+pnpm dev:electron
+'''
+
+[[actions]]
+name = "ios dev"
+icon = "run"
+command = '''
+cd apps/mobile
+pnpm ios
+'''
+
+[[actions]]
+name = "android dev"
+icon = "run"
+command = '''
+cd apps/mobile
+pnpm android
+'''
diff --git a/.gitignore b/.gitignore
index e62bd9c74..490648a22 100644
--- a/.gitignore
+++ b/.gitignore
@@ -37,8 +37,11 @@ apps/desktop/resources/cli
 
 .wrangler
 
-# Local agent artifacts
-.codex/
+# Local agent artifacts, except the shared Codex environment
+.codex/*
+!.codex/environments/
+.codex/environments/*
+!.codex/environments/environment.toml
 
 # E2E outputs
 /apps/desktop/e2e/playwright-report/
diff --git a/.worktreeinclude b/.worktreeinclude
new file mode 100644
index 000000000..21feb5768
--- /dev/null
+++ b/.worktreeinclude
@@ -0,0 +1,2 @@
+# Files copied by Codex into managed worktrees
+apps/desktop/.env