v0.5.1

---

title: Agent Workbench v0.5.1 release notes
doc_type: release-notes
status: published
owner: platform
last_reviewed: 2026-07-07

Agent Workbench v0.5.1

Highlights

• Repackages the Claude Code plugin guidance so Claude receives a concrete
  CLAUDE.md instruction file instead of relying only on SessionStart hook
  prose.
• Corrects stale Agent Workbench tool guidance in packaged hooks, skills, MCP
  instructions, and install docs so clients use tool discovery instead of
  hardcoded client-specific wrapper names.
• Refreshes package, plugin, and install metadata for the 0.5.1 release
  tarball.

Added

• Added repository-level CLAUDE.md guidance that points Claude Code at
  AGENTS.md and requires Agent Workbench-first repository orientation.
• Added packaged Claude plugin CLAUDE.md guidance for Workbench-first tool
  use, deferred schema discovery, and project-level Claude reload behavior.
• Added packaging and validation coverage so the root and plugin Claude
  guidance files are included in the release payload.

Changed

• Updated SessionStart hook output to use client-neutral Agent Workbench tool
  discovery wording instead of stale mcp__agent_workbench references.
• Updated Agent Workbench skills for Codex, Claude Code, and Kiro to avoid
  hardcoded MCP wrapper names.
• Updated MCP server instructions and Codex plugin documentation to describe
  deferred tool discovery without assuming a specific client namespace.
• Includes the committed docs-first warmup metadata and overview/session-start
  tightening work since v0.5.0.
• Updated package manifests, plugin manifests, install URLs, and runbooks to
  version 0.5.1.

Fixed

• Fixed Claude Code packaging so the directive Claude treats as project
  guidance is present in the plugin payload.
• Fixed packaged guidance that could point agents at non-existent or stale
  Agent Workbench tool names after plugin reload.
• Fixed validator and integration tests so missing Claude guidance files or
  stale hook wording fail before release.
• Includes the committed MCP daemon recovery fix for runtime upgrades since
  v0.5.0.

Documentation

• Documented Claude plugin guidance behavior and why hook prose is orientation
  rather than the only workflow authority.
• Updated Codex plugin runbook wording to avoid client-specific MCP tool names.

Validation

• pnpm validate:plugin
• pnpm validate:skills
• pnpm exec vitest run tests/integration/claude-plugin.test.ts tests/integration/hook-cli-compatibility.test.ts tests/integration/codex-hooks-install.test.ts tests/integration/codex-integration-profile.test.ts tests/integration/kiro-power.test.ts tests/mcp/stdio-entrypoint.test.ts
• pnpm typecheck
• git diff --check
• pnpm pack:dry-run
• node scripts/ci/hook-smoke.mjs

Known Issues

• Claude Code still requires plugin reload or restart behavior from the client
  after installing a refreshed package.