# Codex Project Configuration

Codex uses TOML configuration. User-level defaults live in:

```text
~/.codex/config.toml
```

Project-level defaults can live in:

```text
.codex/config.toml
```

Codex loads project `.codex/` layers only for trusted projects. This means a checked-in project config is useful for shared defaults, but Codex may ignore it until the user has trusted the workspace.

## Declarative Plugin Setup

To use the Reliquary marketplace from a project without running the interactive plugin commands, add this to the 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
```

For a local clone:

```toml
[marketplaces.reliquary]
source_type = "local"
source = "/path/to/reliquary"

[plugins."g4b_ai@reliquary"]
enabled = true
```

Add more plugin blocks as needed:

```toml
[plugins."gitea@reliquary"]
enabled = true

[plugins."project-uv@reliquary"]
enabled = true

[plugins."dioxus@reliquary"]
enabled = true
```

The `workpad` skill is part of `g4b_ai`; there is no standalone `workpad@reliquary` plugin.

## Local-Only Settings

Claude supports `.claude/settings.local.json` for uncommitted machine-local overrides. Codex does not currently expose an exact project-file equivalent such as `.codex/config.local.toml`.

Use one of these instead:

- Put personal settings in `~/.codex/config.toml`.
- Use a Codex profile file under `~/.codex/<profile-name>.config.toml` and launch Codex with `--profile <profile-name>`.
- Keep project-specific local notes in `AGENTS.override.md` if they are instructions rather than config.
- If a team deliberately wants local project config files, choose a repo convention and gitignore it, but remember Codex will not auto-merge arbitrary filenames unless Codex adds support for them.

## References

- OpenAI Codex config basics: https://developers.openai.com/codex/config-basic
- OpenAI Codex config reference: https://developers.openai.com/codex/config-reference