Connect Codex
Install the Piyaz plugin in Codex over a hosted MCP server with OAuth.
Connect Codex
Piyaz is hosted at app.piyaz.ai. The plugin installs into Codex once, at the user level, and works in every project you open. No clone required. Run the one-time install, then sign in when prompted (OAuth, once per machine).
Add the marketplace and install
Add the Piyaz marketplace:
codex plugin marketplace add FrkAk/piyazOpen Codex, run /plugin, install Piyaz, restart, and authenticate when prompted. Invoke the main skill with $piyaz.
If your Codex build can't resolve the root marketplace, append --sparse plugins to the command above.
Authenticate
Codex connects to the hosted MCP server over HTTP and runs OAuth on first use. Sign in when Codex prompts you. Authentication is once per machine.
The plugin ships this MCP config (plugins/codex/.mcp.json):
{
"mcpServers": {
"piyaz": { "type": "http", "url": "https://app.piyaz.ai/api/mcp" },
"piyaz-local": { "type": "http", "url": "http://localhost:3000/api/mcp" }
}
}Verify
Ask Codex:
$piyaz List my projects.Codex returns your project list. An empty list is expected on a fresh account.
Self-host
To run Piyaz on your own infrastructure, start the server locally and select the piyaz-local server, which points at http://localhost:3000/api/mcp. Codex reads a hardcoded hosted URL, so for a custom domain edit its .mcp.json directly. For running the server itself, see the self-host guide.
What gets installed
- The 6 MCP tools:
piyaz_project,piyaz_task,piyaz_edge,piyaz_query,piyaz_context,piyaz_analyze. - The
/piyazskill. - The workflow skills: brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and review.
composer (end-to-end task orchestration) and the dispatchable agents are Claude Code only. Codex ships the skills above and runs each phase inline. For the composer loop, use Claude Code.