npx skills add https://github.com/carmandale/agent-config --skill machine-parity在笔记本电脑和 Mac mini 之间快速进行跨机器运行时状态比较。
parity-check.shpi install 或 pi uninstall 后# 人类可读的输出(默认)
~/.agent-config/scripts/parity-check.sh
# 供代理程序使用的 JSON 输出
~/.agent-config/scripts/parity-check.sh --json
| 类别 | 检查项 |
|---|---|
| 代理基础设施 | pi 版本、pi 包、agent-config 的 HEAD/分支、pi-messenger 版本/分支/来源、openclaw 版本 |
| 核心工具 |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| node、claude、codex 版本 |
| Homebrew | 两台机器上是否都安装了所有 20 个 Brewfile 包 |
| 判定结果 | 含义 | 操作 |
|---|---|---|
| PASS | 两台机器具有相同的值 | 无需操作 |
| DRIFT | 机器间的值不同 | 更新落后的机器 |
| DRIFT (expected) | 值不同,但这是有意为之(例如,pi_packages) | 仅作信息参考 |
| MISSING (local/remote) | 工具/包在一侧未安装 | 在缺失侧安装 |
| 代码 | 含义 |
|---|---|
| 0 | 全部为 PASS 或 DRIFT (expected) — 机器同步 |
| 1 | 检测到意外的 DRIFT 或 MISSING |
| 2 | SSH 连接失败或超时 |
| 3 | 缺少依赖项(使用 --json 时需要 jq) |
# 使用 jq 解析
~/.agent-config/scripts/parity-check.sh --json | jq '.[] | select(.verdict != "PASS")'
每个条目包含:check、local、remote、verdict。
| 检查项 | 修复方法 |
|---|---|
| pi_version | ssh mini-ts "pi upgrade" 或 npm update -g @mariozechner/pi-coding-agent |
| claude_version | ssh mini-ts "claude update" |
| codex_version | ssh mini-ts "npm update -g @openai/codex" |
| openclaw_version | 在落后的机器上重新构建并部署 openclaw |
| agent_config_head | 推送应通过双推送自动同步;如果卡住,执行 ssh mini-ts "cd ~/.agent-config && git pull" |
| brew:* MISSING | ssh mini-ts "brew install <package>" |
agent-config-parity 的边界存在两个一致性检查工具 — 各自有不同的范围:
| 工具 | 范围 | 使用时机 |
|---|---|---|
parity-check.sh (本工具) | 运行时状态 — 工具版本、git 状态、Homebrew | "我的机器运行的是相同的东西吗?" |
agent-config-parity | 配置表面 — 符号链接、路径、受管理的表面 | "我的配置文件连接正确吗?" |
pi list 格式依赖:如果 pi 更改其输出格式,pi-messenger 路径提取可能会失效。脚本会回退到 MISSING(不会崩溃)。2026.3.9 与 2026.3.9-beta.1 会正确显示为 DRIFT。每周安装次数
1
仓库
GitHub 星标数
1
首次出现
今天
安全审计
安装于
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
Quick cross-machine runtime state comparison between laptop and Mac mini.
parity-check.shpi install or pi uninstall on either machine# Human-readable output (default)
~/.agent-config/scripts/parity-check.sh
# JSON output for agent consumption
~/.agent-config/scripts/parity-check.sh --json
| Category | Checks |
|---|---|
| Agent infra | pi version, pi packages, agent-config HEAD/branch, pi-messenger version/branch/source, openclaw version |
| Core tools | node, claude, codex versions |
| Homebrew | All 20 Brewfile packages installed on both machines |
| Verdict | Meaning | Action |
|---|---|---|
| PASS | Both machines have the same value | None needed |
| DRIFT | Values differ between machines | Update the behind machine |
| DRIFT (expected) | Values differ but this is intentional (e.g., pi_packages) | Informational only |
| MISSING (local/remote) | Tool/package not installed on one side | Install on the missing side |
| Code | Meaning |
|---|---|
| 0 | All PASS or DRIFT (expected) — machines are in sync |
| 1 | Unexpected DRIFT or MISSING detected |
| 2 | SSH connectivity failure or timeout |
| 3 | Missing dependency (jq for --json) |
# Parse with jq
~/.agent-config/scripts/parity-check.sh --json | jq '.[] | select(.verdict != "PASS")'
Each entry has: check, local, remote, verdict.
| Check | Fix |
|---|---|
| pi_version | ssh mini-ts "pi upgrade" or npm update -g @mariozechner/pi-coding-agent |
| claude_version | ssh mini-ts "claude update" |
| codex_version | ssh mini-ts "npm update -g @openai/codex" |
| openclaw_version | Rebuild and deploy openclaw on the behind machine |
| agent_config_head | Push should auto-sync via dual-push; if stuck, ssh mini-ts "cd ~/.agent-config && git pull" |
| brew:* MISSING |
agent-config-parityTwo parity tools exist — each with a different scope:
| Tool | Scope | Use When |
|---|---|---|
parity-check.sh (this) | Runtime state — tool versions, git state, Homebrew | "Are my machines running the same stuff?" |
agent-config-parity | Config surface — symlinks, paths, managed surfaces | "Are my config files wired correctly?" |
pi list format dependency: If pi changes its output format, the pi-messenger path extraction may break. The script falls back to MISSING (not crash).2026.3.9 vs 2026.3.9-beta.1 correctly shows DRIFT.Weekly Installs
1
Repository
GitHub Stars
1
First Seen
Today
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
114,200 周安装
ssh mini-ts "brew install <package>"