SkillRepo
Sign InSign Up
Catalog
vercel/update-harness-dependencies

vercel

update-harness-dependencies

Update the primary SDK dependencies of harness packages. Use when asked to update the harness SDKs or harness adapter dependencies.

global
internal:true
New~785
v1.0Saved Jul 22, 2026

Update the harness packages

The harness adapters are all the packages/harness-* packages. They each rely on one or more third-party packages for the respective harness's primary SDK. It is crucial to keep those dependencies up to date.

Below you find the instructions on how to update those packages to their latest versions, while adhering to the minimum release age defined in pnpm-workspace.yaml.

Update the harness dependency packages

Run the following commands to update each harness's primary SDK packages.

  • For bridge harnesses (e.g. Claude Code), this will update the packages in devDependencies, while the actual package versions used as dependencies are only relevant to the harness's bridge itself.
  • For non-bridge harnesses (e.g. Pi), this will update the packages in dependencies.

Run these commands exactly as below:

# Claude Code
pnpm --filter harness-claude-code update @anthropic-ai/claude-agent-sdk @modelcontextprotocol/sdk --latest --lockfile-only
# Codex
pnpm --filter harness-codex update @openai/codex-sdk --latest --lockfile-only
# Deep Agents
pnpm --filter harness-deepagents update @langchain/core @langchain/langgraph deepagents langchain langsmith --latest --lockfile-only
# OpenCode
pnpm --filter harness-opencode update @opencode-ai/sdk --latest --lockfile-only
# Pi
pnpm --filter harness-pi update @earendil-works/pi-coding-agent --latest --lockfile-only

For the bridge dependencies of bridge harnesses, you must additionally run the following commands. It is important to specify the config.minimumReleaseAge flag in accordance with what pnpm-workspace.yaml defines, because for these commands the --ignore-workspace flag is needed.

Run these commands exactly as below:

# Claude Code
pnpm --dir packages/harness-claude-code/src/bridge update @anthropic-ai/claude-agent-sdk @anthropic-ai/claude-code @modelcontextprotocol/sdk --latest --ignore-workspace --config.minimumReleaseAge=4320
# Codex
pnpm --dir packages/harness-codex/src/bridge update @openai/codex-sdk --latest --ignore-workspace --config.minimumReleaseAge=4320
# Deep Agents
pnpm --dir packages/harness-deepagents/src/bridge update @langchain/anthropic @langchain/core @langchain/langgraph deepagents langchain langsmith --latest --ignore-workspace --config.minimumReleaseAge=4320
# OpenCode
pnpm --dir packages/harness-opencode/src/bridge update @opencode-ai/sdk opencode-ai --latest --ignore-workspace --config.minimumReleaseAge=4320

Example dependencies

Check the package.json files in examples/harness-e2e-next and examples/harness-e2e-tui for any of the above SDKs they depend on. Those dependencies need to be updated to match the exact version used in the packages as well.

Verification

Run the verification script to ensure all relevant dependency versions are aligned:

./tools/verify-harness-adapter-deps.mjs

If this script shows errors, you must address them, then rerun the verification script until it passes.

Files1
1 files · 552 B

Select a file to preview

Overall Score

81/100

Grade

B

Good

Safety

82

Quality

84

Clarity

88

Completeness

75

Summary

This skill guides agents through updating primary SDK dependencies for harness packages in a monorepo. It provides exact pnpm commands for updating each harness adapter's dependencies (Claude Code, Codex, Deep Agents, OpenCode, Pi), includes instructions for updating bridge-specific dependencies with correct minimum release age flags, and describes verification steps to ensure version alignment across examples.

Detected Capabilities

shell executiondependency management (pnpm)file reading (package.json, pnpm-workspace.yaml)project-scoped updatesverification script execution

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

update harness dependenciesupgrade sdk versionssync harness packagesdependency alignmentharness adapter updates

Risk Signals

INFO

Outbound network requests via pnpm registry

pnpm update commands throughout SKILL.md
INFO

Shell command execution via pnpm with --latest flag

All pnpm update command blocks
INFO

Writing to lockfile via --lockfile-only flag

Primary dependency update commands

Referenced Domains

External domains referenced in skill content, detected by static analysis.

www.apache.org

Use Cases

  • Update Claude Code SDK dependencies to latest compatible versions
  • Keep Deep Agents and LangChain dependencies synchronized across harness packages
  • Update OpenAI Codex and OpenCode SDK versions in harness adapters
  • Maintain dependency version alignment between package.json files and bridge implementations
  • Verify harness adapter dependencies match across main packages and example projects

Quality Notes

  • Clear hierarchical structure with distinct sections for main dependencies, bridge dependencies, examples, and verification
  • Exact copy-paste commands provided for each harness type, reducing transcription errors
  • Explicit documentation of minimum release age configuration and --ignore-workspace rationale
  • Verification step with specific script path ensures validation of correctness
  • Well-scoped to internal monorepo structure with clear file paths
  • Includes context about the distinction between bridge and non-bridge harnesses
  • Example section acknowledges need to keep example project versions aligned
  • Commands are specific and testable — agent knows exactly what to run and in what order
Model: claude-haiku-4-5-20251001Analyzed: Jul 22, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use vercel/update-harness-dependencies in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...