harness-mix

Name: harness-mix
Author: emo-xiaoyu

Verified

194stars

9forks

TypeScript

Added 9/23/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/emo-xiaoyu/harness-mix

Getting Started

Guides for using ai agents skills like harness-mix.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 9/23/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@vitest/mocker: Vitest: Path Traversal / Arbitrary File Read via @vitest/mocker Redirect Mock",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vitest: Vulnerability found",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-09-23T09:06:46.107Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

Compare with similar skills

See how harness-mix compares with popular alternatives.

harness-mix vs hermes agent

See comparison

harness-mix vs ecc

See comparison

harness-mix vs everything claude code

See comparison

README.md

Frequently Asked Questions

What is harness-mix?

harness-mix is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by emo-xiaoyu. It has 194 GitHub stars.

Is harness-mix safe to use?

Yes. harness-mix passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install harness-mix?

Clone the repository with "git clone https://github.com/emo-xiaoyu/harness-mix" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is harness-mix written in?

harness-mix is primarily written in TypeScript. It is open-source under emo-xiaoyu on GitHub, so you can review or fork the full source.

Are there alternatives to harness-mix?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh harness-mix against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

266,366

formax magpie

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Harness Mix

macOS/Linux 已加入源码构建与启动适配；目标系统的完整桌面验收仍需在对应机器执行。安装方式、Linux 桌面前提和支持边界见跨平台指南。

Harness Mix 是接入官方 Codex Desktop 原生界面的本地内核。它通过本地编译的 CLI Shim 对接桌面的 app-server 协议，把包括 Antigravity、Codex、Pi、Oh My Pi、Claude Code、DeepSeek Harness、OpenCode、Grok、OpenClaw、Hermes、Qoder、CodeBuddy、Kiro CLI、Cursor CLI、ZCode、Trae 和 Cline 在内的原生 Coding Harness 接入同一套 UI。Host Runtime 与 Protocol Core 管理任务映射、协作和事件投影；模型调用、工具执行、原生会话与凭据仍由各 Harness 自己管理。

界面预览

预览来自当前 Codex Desktop 原生窗口：Harness Mix 作为原生扩展入口出现在桌面工具栏和 Composer 中，会话、模型、工具与权限仍由 Codex Desktop 及各 Harness 管理。

功能模块	核心能力	交互入口与特点
🔄 跨 Harness 任务接力	4 种接力模式（继续执行 / 执行计划 / 独立审查 / 重新分析）平滑交接	输入框接力角标 / `/switch`；持久化脱敏检查点与证据追溯
🎨 皮肤市场	内置 HeiGe、Codex Styler、Dream Skin 与经典编辑器配色主题，支持亮色 / 暗色、背景装饰和可读性保护	设置 → 皮肤；一键预览、应用和恢复原生外观
📚 历史会话导入与引用	一键导入 Pi / Claude / Codex / CodeBuddy 原生历史并可中断续跑；`#` 引用任意旧会话注入脱敏上下文	引用仅预取最近一页；MCP 只读工具 `get_session_info` / `list_session_messages` 供 Harness 按需翻页与读取分支 / 模型 / 用量元数据
🤝 多 Agent 协同编排	输入 `#` 唤起目标 Harness，胶囊标签直观管理，主控强约束派发	输入框 `#` 菜单；支持循环审查验证、子任务级联取消与超时熔断
🧩 原生 Skills 管理	全量覆盖 17 个 Harness 原生技能目录，会话启动自动预建根目录	设置 → Skills；支持单个 `SKILL.md` 或完整文件夹直接拖拽安装
🛠️ 原生 MCP 扩展	支持本地 stdio 与远程 Streamable HTTP / SSE 协议	设置 → MCP；支持自定义 Header 传递，按 Harness 独立生效
📋 原生消息队列	完整接入 Codex 会话排队机制（增删改查、排序、插队抢占与自动排空）	原生 Composer 队列；当前回合完成后自动顺序调度执行排队消息
✅ 可配置验证门禁	任务级 off / advisory / required 策略，内置一致性检查与自定义验证命令	命令面板 `/gate`、`/verify`；强制模式保护隔离分支合并与推送
💾 会话存储治理	schema v3 分片惰性加载、无损紧凑存储、迁移备份与体积诊断	冷启动只读任务索引；打开任务时才恢复对应 Core checkpoint
🩹 失败分类与恢复	失败回合归类为连接 / 登录 / 额度 / 被拒 / 服务异常五类，分类来自原生结构化错误（Codex `codexErrorInfo` 透传）、状态码或消息特征，无法归类时诚实标注 unknown	错误状态随任务投影；Renderer 可查 `harnessmix/harness/turn-error` 获取分类与动作（重试 / 去登录 / 新建会话），login 按钮按 Harness 真实登录能力出现
🌐 ChatGPT 侧边栏桥接	安全脱敏提取当前会话上下文并一键生成结构化草稿	Web 快捷聊天面板；直通注入 ChatGPT，实现跨工具无缝协作
👤 账户与用量隔离	Codex 多账户隔离与即时切换；实时追踪 Token / Credits 用量	原生侧边栏与设置面板；各 Harness 凭据、模型与审批原生自理

🎨 皮肤市场预览

主题资源随项目发布，图片直接使用仓库内的授权素材；应用皮肤只改变视觉层，不改变 Codex 原生交互和 Harness 执行行为。

原生 Harness 功能支持矩阵

💡 设计原则：所有能力严格在 Adapter manifest 中诚实声明，界面按真实能力渲染，不依靠名称猜测。凭据、模型、工具与权限审批始终由原生 Harness 独立掌控。

Harness	原生接入协议	流式输出	思考推理	工具审批	用户提问	会话恢复/Fork	图片附件	原生 Skills	MCP 扩展
Antigravity	`agy` CLI (`stream-json` / Hook)	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
Codex	`codex app-server --stdio`	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
Claude Code	`@anthropic-ai/claude-agent-sdk`	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
Pi	`pi --mode rpc`	✅	✅	✅	✅	✅ / ✅	✅	✅	➖
Oh My Pi	`omp --mode rpc` (`pi-family.js`)	✅	✅	✅	✅	✅ / ✅	✅	✅	➖
DeepSeek	普通 Web Remote / 协作 ACP	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
OpenCode	`opencode serve` (HTTP / SSE)	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
Grok	`grok agent stdio` (`_x.ai/*`)	✅	✅	✅	✅	✅ / ✅	✅	✅	✅
OpenClaw	Gateway WebSocket Loopback	✅	➖	✅	➖	✅ / ➖	✅	✅	✅
Hermes	`hermes acp`	✅	✅	✅	➖	✅ / ✅	✅	✅	✅
CodeBuddy	`codebuddy --acp` (`_codebuddy.ai/*`)	✅	✅	✅	✅	✅ / ➖	✅	✅	✅
Kiro CLI	`kiro-cli acp` (`_kiro/*`)	✅	✅	✅	✅	✅ / ✅	➖	✅	✅
Cursor CLI	`cursor-agent acp` (`cursor/*`)	✅	✅	✅	✅	✅ / ➖	➖	✅	✅
Qoder	`qoder --acp`	✅	➖	✅	➖	✅ / ➖	✅	✅	✅
ZCode	`zcode.cjs app-server --stdio`（ZCode Protocol v1）	✅	✅	✅	✅	✅ / ➖	✅	✅	➖
Trae	兼容 ACP 桥接程序	✅	➖	✅	➖	✅ / ➖	➖	✅	✅
Cline	`cline --acp`	✅	✅	✅	➖	✅ / ➖	✅	✅	✅

注：✅ 为原生支持并已打通；➖ 为上游协议当前未开放或未声明；只有本机已安装且握手成功的 Harness 才会进入真实运行。详见原生 ACP 深度适配与 Harness 管理说明。

核心功能特色

🔄 跨 Harness 任务接力（Task Handoff）

一个 Harness 负责深入分析，另一个编写具体实现，再切回原 Harness 交叉复核——整个过程无缝保留在同一个 Codex Desktop 原生窗口中：

现场完整保留：保留对话历史、未提交代码改动、Git 状态与 Review 记录。
持久化检查点：创建带哈希的接力快照，自动脱敏测试证据与敏感密钥，支持随时暂停与恢复。
独立会话恢复：每个 Harness 的原生 Session 与参数独立保存，切回时调用其原生恢复机制（如 Pi --session 或 Claude resume）。
四种接力方式：支持「继续执行」、「执行上一方案」、「独立审查」与「重新分析」。

🤝 多 Agent 协同编排（Multi-Agent Collaboration）

触发符解耦：在原生输入框输入 # 调出协同菜单（#pi、#claude、#codex、#dsh），完全保留官方 @ 菜单给 Codex 原生功能。
标签可视化：已选协同 Agent 在输入框顶部呈现为胶囊标签，支持点击快速删除或 Backspace 撤销。
严谨编排约束：自动为主控 Coordinator 注入硬约束，严禁越界派发给未指定的 Harness；完善级联取消与子任务超时熔断机制。
真正的 Agent Team：一个 Lead 可组织最多六个并发的具名 Harness 成员；Team、职责、共享任务依赖图和成员邮箱均由 Host 持久化，teammate 可直接定向通信、交接和反馈，而不是只把并行结果返回 Lead。
独立开关：「设置 → 协作」中「多 Agent 协作」与「Agent Team」是两个独立开关（默认均开启）；关闭协作即同时停用团队，关闭团队则保留一次性委派。
原生 Team Workbench：对话顶部团队驾驶舱点击「展开详情」后在 Codex 内容流内显示唯一主导者、各成员职责、独立任务列、进度、通信流和事件回放，不覆盖原生侧栏、消息或输入框；成员卡片可跳转其原生子任务。状态直接向 Host 实时刷新，各成员仍使用自己的原生 Harness Session、模型、工具、权限和账户。
统一 Workspace 能力：全部 Harness 由 Host 统一获得 Git 探测、Worktree 隔离和最终快照 Diff；原生实时 Diff 继续按各 Harness 实际协议叠加。显式隔离失败不会降级到共享目录。

🧩 原生 Skills 与 MCP 管理

17 平台免配置预建：打开会话时自动预建全部 17 个 Harness 声明的原生 Skills 根目录，新安装 Harness 也能即开即用。
拖拽安装：在「设置 → Skills」中可将单个 SKILL.md 或完整技能文件夹直接拖拽安装，自带安全路径校验。
作用域与安全停用：支持 Global（全局）与 Project（项目级）无缝切换；停用时安全移入保留目录，绝不损坏用户源文件。
远程 MCP 支持：支持配置带自定义 Headers 的 Streamable HTTP / SSE 远程服务。

🎨 皮肤市场与可读性保护

主题预览与切换：设置 → 皮肤中可预览并应用内置主题，也可随时恢复原生 Codex 外观。
全界面覆盖：背景、侧边栏、消息卡片、输入框、按钮和文字颜色统一使用主题令牌。
暗色可读性：自动增加遮罩和对比度，避免侧边栏、任务列表和消息内容在深色背景上消失。
**交