机器一致性检查工具：跨设备状态对比与同步解决方案

machine-parity by carmandale/agent-config

1 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/carmandale/agent-config --skill machine-parity

自动化开发运维命令行工具

🇨🇳中文介绍

机器一致性检查

在笔记本电脑和 Mac mini 之间快速进行跨机器运行时状态比较。

使用时机

"我的机器同步了吗？" — 运行 parity-check.sh
推送 agent-config 更改后（验证双推送已生效）
在一台机器上升级 pi、claude、codex、openclaw 或 node 后
在任一机器上执行 pi 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 开发者，精准高效

联系我们

判定结果	含义	操作
PASS	两台机器具有相同的值	无需操作
DRIFT	机器间的值不同	更新落后的机器
DRIFT (expected)	值不同，但这是有意为之（例如，pi_packages）	仅作信息参考
MISSING (local/remote)	工具/包在一侧未安装	在缺失侧安装

代码	含义
0	全部为 PASS 或 DRIFT (expected) — 机器同步
1	检测到意外的 DRIFT 或 MISSING
2	SSH 连接失败或超时
3	缺少依赖项（使用 --json 时需要 jq）

供代理程序使用的 JSON 输出

# 使用 jq 解析
~/.agent-config/scripts/parity-check.sh --json | jq '.[] | select(.verdict != "PASS")'

每个条目包含：check、local、remote、verdict。

常见的 DRIFT 修复方法

检查项	修复方法
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（不会崩溃）。
openclaw 预发布后缀：作为原始字符串进行比较。2026.3.9 与 2026.3.9-beta.1 会正确显示为 DRIFT。
pi_packages 有意差异：包的设计上就不同（笔记本电脑有更多）。显示为 DRIFT (expected)，不影响退出码。

🇺🇸English

Machine Parity Check

Quick cross-machine runtime state comparison between laptop and Mac mini.

When to Use

"Are my machines in sync?" — run parity-check.sh
After pushing agent-config changes (verify the dual-push landed)
After upgrading pi, claude, codex, openclaw, or node on one machine
After pi install or pi uninstall on either machine
When debugging behavior differences between machines

How to Run

# Human-readable output (default)
~/.agent-config/scripts/parity-check.sh

# JSON output for agent consumption
~/.agent-config/scripts/parity-check.sh --json

What It Checks

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

Understanding the Output

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

Exit Codes

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)

JSON Output for Agents

# Parse with jq
~/.agent-config/scripts/parity-check.sh --json | jq '.[] | select(.verdict != "PASS")'

Each entry has: check, local, remote, verdict.

Common DRIFT Fixes

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

Boundary with `agent-config-parity`

Two 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?"

Known Limitations

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).
openclaw pre-release suffixes : Compared as raw strings. 2026.3.9 vs 2026.3.9-beta.1 correctly shows DRIFT.
pi_packages intentional drift : Packages differ by design (laptop has more). Shown as DRIFT (expected), doesn't affect exit code.

Weekly Installs

Repository

carmandale/agent-config

GitHub Stars

First Seen

Today

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

114,200 周安装

ssh mini-ts "brew install <package>"

机器一致性检查工具：跨设备状态对比与同步解决方案

🇨🇳中文介绍

机器一致性检查

使用时机

如何运行

检查内容

相关 Skills

理解输出

退出码

供代理程序使用的 JSON 输出

常见的 DRIFT 修复方法

与 `agent-config-parity` 的边界

已知限制

🇺🇸English

Machine Parity Check

When to Use

How to Run

What It Checks

Understanding the Output

Exit Codes

JSON Output for Agents

Common DRIFT Fixes

Boundary with `agent-config-parity`

Known Limitations

最新 Skills

机器一致性检查工具：跨设备状态对比与同步解决方案

🇨🇳中文介绍

机器一致性检查

使用时机

如何运行

检查内容

相关 Skills

理解输出

退出码

供代理程序使用的 JSON 输出

常见的 DRIFT 修复方法

与 agent-config-parity 的边界

已知限制

🇺🇸English

Machine Parity Check

When to Use

How to Run

What It Checks

Understanding the Output

Exit Codes

JSON Output for Agents

Common DRIFT Fixes

Boundary with agent-config-parity

Known Limitations

最新 Skills

与 `agent-config-parity` 的边界

Boundary with `agent-config-parity`