golem-update-running-agents

Migrate running agents to new component revisions via auto replay or snapshots.

Updated May 17, 2026
One-click install
npx skills add https://github.com/Rust-soham/golem-claw --skill golem-update-running-agents-rust-soham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golem-update-running-agents
Source: https://github.com/Rust-soham/golem-claw/tree/main/packages/golem/.agents/skills/golem-update-running-agents
Command: npx skills add https://github.com/Rust-soham/golem-claw --skill golem-update-running-agents-rust-soham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updating a deployed component version does not automatically migrate already-running agents, leaving them stuck on the old code path unless you explicitly trigger an agent update.

Core Features & Use Cases

  • Update Modes (auto/manual): Choose automatic replay of the operation log for compatible changes or snapshot-based migration when the component interface/state changes.
  • Multiple Update Paths: Update during deploy for all affected agents, or update agents explicitly/bulk via component or application commands.
  • Operational Controls: Support waiting for completion and optionally preventing wakeups for suspended agents.

Quick Start

Run a deploy that updates existing agents using automatic mode so their operation logs are replayed against the new component version.

Frequently Asked Questions about golem-update-running-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update running agents to a new component version without losing state?

To update running agents without losing state, you can trigger an agent update that either auto-replays the operation log against the new component version or performs manual snapshot-based state migration using save-snapshot and load-snapshot exports.

When should I use snapshot migration instead of automatic operation log replay for agent updates?

You should use snapshot migration instead of automatic operation log replay when the component interface or state changes break compatibility, requiring manual state transfer via save-snapshot and load-snapshot exports.

Can I update all running agents in bulk when deploying a new application component revision?

Yes, you can update all affected running agents in bulk during a deploy, or target them explicitly via component and application commands, allowing them to switch to the newly deployed revision without losing behavioral continuity.

What happens to suspended agents during a component version migration?

During component version migration, operational controls allow you to wait for completion and optionally prevent wakeups for suspended agents, ensuring they remain suspended until the update process is fully finalized.

Why do my deployed agents stay on the old code path after a component version upgrade?

Deployed agents stay on the old code path because deploying a new component version does not automatically migrate them; you must explicitly trigger an agent update to switch their execution to the newly deployed revision.

Does the golem-update-running-agents Skill support individual agent updates alongside bulk application updates?

Yes, the Skill supports individual agent updates, bulk application updates, and component-wide updates, providing multiple paths to migrate already-running agents to a new component revision while preserving behavioral continuity.