os-clean-locks

Community

Clear stale locks, restore agent flow.

Authorrichfrem
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Safely removes all agent lock files from the context/.locks/ directory to resolve deadlocks caused by crashed agents leaving stale locks behind. Verifies lock existence, discovers and removes stale lock directories, updates OS state via kernel.py, and emits event bus notifications. Requires Python 3.8+ and standard library only.

Core Features & Use Cases

  • Detects stale locks and reports their locations.
  • Removes lock directories safely without affecting non-lock files.
  • Updates kernel state and emits events to notify downstream components.

Quick Start

Invoke the os-clean-locks action to scan context/.locks for stale locks and remove them, preparing the system for normal operation.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: os-clean-locks
Download link: https://github.com/richfrem/agent-plugins-skills/archive/main.zip#os-clean-locks

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.