How qingliangcn/codex-with-workbuddy works
Codex Agent Delegator is a Codex plugin that exposes a local MCP server and a companion Skill for bounded analysis and public-web research. The main workflow is Codex invoking an MCP tool: the server either delegates work to WorkBuddy or fetches and extracts public web content, then returns text for Codex to use. The README documents the tool capabilities and configuration; the sampled server excerpt shows dispatch, URL-fetch handling, and transcript fallback. Other internal details are represented only where those excerpts support them.
Main entry points: workbuddy_mcp_server.py Tool Dispatch · plugin.json Plugin Manifest · SKILL.md Delegator Skill
Components 11
Codex Integration
- Plugin Manifest
.codex-plugin/plugin.json - Delegator Skill
skills/codex-agent-delegator/SKILL.md - MCP Server
scripts/workbuddy_mcp_server.py - Tool Dispatch
scripts/workbuddy_mcp_server.py
WorkBuddy Delegation
- WorkBuddy CLI
- Transcript Recovery
scripts/workbuddy_mcp_server.py
Web Research
- Public URL Fetch
scripts/workbuddy_mcp_server.py - Text Extraction
scripts/workbuddy_mcp_server.py - Temporary Text Input
scripts/workbuddy_mcp_server.py - Public Websites
Other components
- Codex
Connections 12
- Codex → Plugin Manifest: installs
README.md - Codex → MCP Server: invokes tools
README.md - Codex → Delegator Skill: uses guidance
README.md - MCP Server → Tool Dispatch: dispatches
scripts/workbuddy_mcp_server.py - Tool Dispatch → WorkBuddy CLI: delegates analysis
scripts/workbuddy_mcp_server.py - Tool Dispatch → Public URL Fetch: requests fetch
scripts/workbuddy_mcp_server.py - Public URL Fetch → Public Websites: requests pages
README.md - Public URL Fetch → Text Extraction: extracts text
scripts/workbuddy_mcp_server.py - Tool Dispatch → Temporary Text Input: writes fetched text
scripts/workbuddy_mcp_server.py - Temporary Text Input → WorkBuddy CLI: supplies summary input
scripts/workbuddy_mcp_server.py - WorkBuddy CLI → Transcript Recovery: recovers output from
README.md - Tool Dispatch → Codex: returns results
README.md