golem-debug-agent-history

Dump or search golem agent oplogs by index or Lucene query.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you investigate why a golem agent behaved unexpectedly by letting you inspect the agent’s recorded operation history (oplog) and locate relevant events, errors, and side effects.

Core Features & Use Cases

  • Oplog dump and search: Retrieve the entire operation log or filter it by starting index or a Lucene query.
  • Actionable debugging context: Read structured, labeled entries for creation, calls, invocations, persistence/snapshot events, plugin lifecycle, errors, and more.
  • Workflow integration: Use it when dumping or searching oplog history to pinpoint the sequence that led to faulty behavior.

Quick Start

Run golem agent oplog <AGENT_ID> --query "error" to find error-related entries in the agent’s history.

Frequently Asked Questions about golem-debug-agent-history

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

FAQPage Schema
How do I debug unexpected golem agent behavior by inspecting the operation log?

You can debug unexpected golem agent behavior by dumping or searching the agent's operation log. This allows you to inspect recorded history, locate relevant events, and pinpoint the sequence that led to faulty actions.

How do I search a golem agent's oplog for specific errors or events?

You can search a golem agent's oplog by running golem agent oplog <AGENT_ID> --query "error" with a Lucene query string. This filters the operation log to locate specific errors, invocations, and side effects.

What types of entries are recorded in the golem agent oplog?

The golem agent oplog records structured entries for creation, calls, invocations, persistence, snapshot events, plugin lifecycle, and errors. These categorized entries provide actionable debugging context for agent behavior.

Can I retrieve the entire operation log for a golem agent without filtering?

Yes, you can retrieve the entire operation log for a golem agent by dumping the full oplog. This outputs all recorded history without applying a starting index or Lucene query filter.

Can I use both a starting index and a Lucene query to filter the golem oplog?

No, you cannot use both a starting index and a Lucene query simultaneously. The golem oplog search enforces mutual exclusivity between the from index parameter and the query string.

Does the golem oplog debugging skill work with both golem and golem-cli?

Yes, the golem oplog debugging skill supports querying operation logs across both golem and golem-cli. It renders categorized oplog entry types with relevant fields for investigation.