SAService Architect Back to designer
SAService ArchitectDocumentation
Codex integration guide

Install the Codex plugin

Install Service Architect from its public repository marketplace and open a new Codex task so the MCP server and skills are discovered.

When to use

Install once per Codex environment, then update the marketplace installation when a newer plugin version is published.

Behavior

  • The repository marketplace is declared in .agents/plugins/marketplace.json.
  • The plugin manifest is plugins/service-architect/.codex-plugin/plugin.json; the MCP process is configured by plugins/service-architect/.mcp.json.
  • Codex loads the packaged skills and starts the Python MCP server through the package revision pinned by the plugin.
  • Open a new task after installation or update so tool discovery starts with the new plugin definition.

Installation sources properties

Files used by Codex plugin discovery.

PropertyTypeDescription
Plugin packageDirectory
MCP configurationJSON

Repository marketplace

git clone https://github.com/gorundebug/sa-python-dsl.git
cd sa-python-dsl

# Add this repository marketplace in Codex, install Service Architect,
# then open a new task in the Python topology project.