📝 Document Codex project config

2026-05-30 15:28:38 +02:00
parent 3704e2d463
commit 8d2613138c
2 changed files with 93 additions and 1 deletions
@@ -65,7 +65,29 @@ codex plugin marketplace add /path/to/reliquary
 codex plugin add g4b_ai@reliquary
 ```

-A project can mirror the checked-in `.codex/config.toml` shape to prefer Codex-native marketplace and plugin declarations.
+Or declaratively in a project's `.codex/config.toml`:
+
+```toml
+[marketplaces.reliquary]
+source_type = "git"
+source = "git@git.g4b.org:dirigence/reliquary.git"
+
+[plugins."g4b_ai@reliquary"]
+enabled = true
+```
+
+From a local clone:
+
+```toml
+[marketplaces.reliquary]
+source_type = "local"
+source = "/path/to/reliquary"
+
+[plugins."g4b_ai@reliquary"]
+enabled = true
+```
+
+Codex project config is read only for trusted projects. Codex does not currently have a direct `settings.local.json` equivalent; use user-level `~/.codex/config.toml`, profiles, or an intentionally gitignored local workflow for machine-private settings.

 ## ✂️ Grab pieces independently