Permission profiles
observe reads bounded state. develop adds lifecycle and approved actions. maintain adds rebuild and proposal creation. admin is explicit and never the default.
Integration
Codex integration
Codex uses Switchyard’s typed MCP tools for project lifecycle and its own repository tools for source work.
Safe setup
Connect in three reviewed steps.
- Run `switchyard agent install codex`.
- Choose an observe or develop profile.
- Use MCP tools to inspect status before any mutation.
Start with observation only.
Expand to `develop` after reviewing project scope and the mutation tools that become available.
switchyard agent install codex --profile observeSafe workflow
List projects, read status, queue one mutation with a stable request ID, wait for the durable operation, then verify health and redacted errors.
Authorization failures
A missing tool means the profile or project scope does not grant it. Change the reviewed local configuration; prompt text cannot grant capability.
Remove the integration
Remove the client MCP entry created by the installer. This does not delete Switchyard projects, local data, or the daemon.
Canonical contract