diff --git a/.codex/config.toml b/.codex/config.toml
new file mode 100644
index 0000000..871c290
--- /dev/null
+++ b/.codex/config.toml
@@ -0,0 +1,5 @@
+# Repo-local Codex defaults for this workspace.
+
+sandbox_mode = "workspace-write"
+approval_policy = "on-request"
+allow_login_shell = true
diff --git a/.gitignore b/.gitignore
index 9afdb0f..6f68f13 100644
--- a/.gitignore
+++ b/.gitignore
@@ -65,3 +65,8 @@ projects/
 # Claude Code (commit shared settings; ignore machine-local perms + transcripts)
 .claude/*
 !.claude/settings.json
+
+# Codex CLI
+!.codex/
+.codex/*
+!.codex/config.toml
diff --git a/README.md b/README.md
index 22b76c6..36da537 100644
--- a/README.md
+++ b/README.md
@@ -167,3 +167,7 @@ Research based on [solanabox.tools](https://solanabox.tools/) ecosystem director
 (DappUniversity, Handsome Finance, Orangie Web3, EducationalPasha, WarrenGuru, SolPump.io).
 
 _Generated: February 2026 — Updated: April 2026_
+
+## Codex CLI
+
+Codex CLI can use the repo root `AGENTS.md` and the tracked `.codex/config.toml` defaults in this workspace.