Agent skill · software engineering · lobehub
heterogeneous-agent
Use for external-agent launchers and execution identity, Claude Code/Codex adapters, IPC, event mapping, sessions, persistence and tool-call chains.
Why this skill is useful
Adds specific debugging procedures and executable scripts for heterogeneous agent pipelines that are not covered in general programming knowledge.
What it needs
Requires electron installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 81,352 stars on the source repository.
What this skill does
Heterogeneous Agent Development Use this skill when the bug or feature lives in the external CLI agent pipeline, not the normal server-side agent runtime. Use This Skill For 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.HETEROAGENTTRACE, or executeHeterogeneousAgent Fixing Claude Code stream-json bugs such as duplicate partial/full chunks, broken message.id boundaries, missing toolresult, 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 Pipeline Map 1. CLI raw stdout / JSONL 2. Electron main spawns the CLI and broadcasts heteroAgentRawLine 3. Adapter maps raw provider events into HeterogeneousAgentEvent 4. executeHeterogeneousAgent persists assistant/tool messages and forwards stream events 5. createGatewayEventHandler hydrates the UI 6. Only after this path looks correct should you move on to agent-tracing or context-engine debugging Read These Files First apps/desktop/src/main/controllers/HeterogeneousAgentCtr.ts apps/desktop/src/main/modules/heterogeneousAgent/drivers/claudeCode.ts apps/desktop/src/main/modules/heterogeneousAgent/drivers/codex.ts packages/heterogeneous-agents/src/adapters/claudeCode.ts packages/heterogeneous-agents/src/adapters/codex.ts src/store/chat/slices/agentRun/actions/transports/hetero/heterogeneousAgentExecutor.ts src/store/chat/slices/agentRun/actions/tests/heterogeneousAgentExecutor.test.ts Default Debug Order 1. Prove whether the raw CLI output is correct before touching UI code. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills lobehub/heterogeneous-agent