Repository navigation
Codex skill/MCP: message Grok Bot via gbot send #25
Description
Summary
Ship a Codex-facing skill (and optionally a thin MCP/plugin) so Codex agents can reach Grok Bot the same way we already reach bots from the shell: gbot send <bot-or-group> <message>.
Parent: track under the bidirectional bridge epic.
Why this first
Reverse direction (Codex→Grok) has no app-server attach problem. gbot already talks to the Grok Bot gateway. Teaching Codex to call it unblocks coordination immediately.
Proposed shape
- Skill (or plugin skill) with clear description: when to ping Grok, how to name the bot/group, message format
- Optional MCP tool wrappers:
gbot_send,gbot_thread(read recent chat) - Document auth on Codex hosts:
GROK_BOT_GATEWAY_URL+GROK_BOT_GATEWAY_TOKEN, Grok Bot app session, orCURSOR_ACCESS_TOKEN - Example AGENTS.md snippet for repos that want default routing to
Generalor a specialist bot
Acceptance criteria
- Installable from this repo (Codex plugin marketplace entry or documented skill path)
-
gbot sendworks from a Codex turn with sandbox/network policy called out - README section: “Talking to Grok Bot from Codex”
- Smoke-tested on ubuntu-main and Mac Studio Codex CLI / Desktop where
gbotis on PATH
Non-goals
- Replicating Desktop’s “Sent by ChatGPT from another task” UX
- Scraping Desktop IPC pipes
Activity
ScriptedAlchemy commentedon Sep 15, 2026
GPT-6 Pro packaging guidance (chatgpt.com, 2026-09-14)
Ordering
gbot_send,gbot_thread(+ optional restricted target list).Implementation corrections
commands.js/ gateway), not shell out togbot sendand parse stdout.--stdin,--) so agent text cannot be eaten as flags.clientNonce/replyToIdvia CLI if useful for correlation.plugin.json,skills/,mcp.json(.codex-plugin/as fallback only).filesallowlist includes skills/plugin/docs or publish will omit them.Suggested tool profile
Acceptance still stands; add:
npm pack/ clean install includes skill + MCP assets--message path smoke-testedSource: model 6 Pro on chatgpt.com.
feat(plugin): add the grok-bot Agent Bundle plugin (#27)