OpenAI Codex
Install the RelayAPI plugin for OpenAI Codex to manage social media posts from the Codex CLI.
The RelayAPI plugin for OpenAI Codex brings social media management to the Codex CLI. Use natural language to create posts, manage accounts, and schedule content.
Quick Reference
| Platform | OpenAI Codex CLI |
| Version | 1.0.0 |
| Auth | RELAYAPI_API_KEY environment variable |
| Distribution | Repository marketplace or personal install |
Self-serve publishing to the official Codex Plugin Directory is coming soon. For now, install via repository or personal marketplace.
Install
Option A: Repository Marketplace (Team)
Add the plugin to your project so team members get it automatically:
mkdir -p ./plugins
cp -R packages/integrations/codex-plugin ./plugins/relayapiCreate $REPO_ROOT/.agents/plugins/marketplace.json:
{
"name": "relayapi-plugins",
"interface": {
"displayName": "RelayAPI Plugins"
},
"plugins": [
{
"name": "relayapi",
"source": {
"source": "local",
"path": "./plugins/relayapi"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
}
]
}Restart Codex to discover the plugin.
Option B: Personal Install
Install for your user only:
mkdir -p ~/.codex/plugins
cp -R packages/integrations/codex-plugin ~/.codex/plugins/relayapiCreate or update ~/.agents/plugins/marketplace.json:
{
"name": "personal-plugins",
"interface": {
"displayName": "My Plugins"
},
"plugins": [
{
"name": "relayapi",
"source": {
"source": "local",
"path": "~/.codex/plugins/relayapi"
},
"policy": {
"installation": "INSTALLED_BY_DEFAULT"
},
"category": "Productivity"
}
]
}Restart Codex.
Setup
Set your API key as an environment variable:
export RELAYAPI_API_KEY="rlay_live_your_key_here"Get your key from relayapi.dev under Settings > API Keys.
Usage
Skills
Invoke the RelayAPI skill in Codex:
$relayapi — post "Hello world!" to TwitterOr use the guided post composer:
$social-postExample: Natural Language
Use RelayAPI to post to Twitter and LinkedInUse RelayAPI to list my connected social media accountsUse RelayAPI to schedule a post for tomorrowWhat's Included
Skills
- RelayAPI Reference — Full API documentation with TypeScript SDK examples and all 21 platform details
- Social Post Composer — Step-by-step post creation with platform validation and confirmation
Updating
- Update skill content in
skills/*/SKILL.md - Bump
versionin.codex-plugin/plugin.json - Re-copy to the target location
- Restart Codex
Links
Found something wrong? Help us improve this page.