External Agent Adapters

Builds adapters that run external agents such as Claude Code and Codex.

npx skills add lobehub/lobehub --skill heterogeneous-agent -g -a claude-code -y

Press to copy:C Claude CodeX CodexU CursorA Ask your agent

What it does

Use for external-agent launchers and execution identity, Claude Code/Codex adapters, IPC, event mapping, sessions, persistence and tool-call chains.

Use this skill when the bug or feature lives in the external CLI agent pipeline, not the normal server-side agent runtime.

Adding or changing a driver under apps/desktop/src/main/modules/heterogeneousAgent/drivers/
Editing an adapter under packages/heterogeneous-agents/src/adapters/
Changing CLI/Desktop dispatch launchers, including OpenClaw/Hermes, or debugging task-comment authorship
Debugging heteroAgentRawLine transport, window.__HETERO_AGENT_TRACE, or executeHeterogeneousAgent
Fixing Claude Code stream-json bugs such as duplicate partial/full chunks, broken message.id boundaries, missing tool_result, TodoWrite state drift, or subagent thread routing
Fixing Codex JSONL bugs such as mixed multi-tool messages, broken turn boundaries, or missing tool-result mapping
Fixing step-boundary, tool persistence, subagent thread, or resume bugs in Claude Code / Codex flows
Reproducing multi-tool mixing, orphan tool messages, or stuck tool-result loading

CLI raw stdout / JSONL
Electron main spawns the CLI and broadcasts heteroAgentRawLine
Adapter maps raw provider events into HeterogeneousAgentEvent
executeHeterogeneousAgent persists assistant/tool messages and forwards stream events
createGatewayEventHandler hydrates the UI
Only after this path looks correct should you move on to agent-tracing or context-engine debugging