What is the primary purpose of the Session Replay skill?

It is designed to turn a non-deterministic Gardener runtime failure into a deterministic session recording and integration test for easier debugging and validation.

What happens to the replay test once a bug is fixed?

The replay test is designed to pass when it successfully reproduces the error; once the bug is fixed, the test will fail, confirming the resolution.

What file format does the recording use?

The recording uses a JSONL (JSON Lines) format where each line represents a RecordEntry, including session starts, backlog snapshots, and process calls.

Where should I save the generated recording files?

Recording fixtures should be stored in the tools/gardener/tests/fixtures/ directory and committed to your repository.

How do I find the run.id required for the replay?

You can use the provided grep or jq commands to search the ~/.gardener/otel-logs.jsonl file for the specific error message or worker ID associated with the failure.

Gardener Session Replay

Name: Gardener Session Replay
Author: carterbs

bycarterbs

0•

Security & Testing

Generates deterministic session recording files and reproduction tests from Gardener TUI runtime errors.

The Session Replay skill provides a structured workflow for debugging Gardener worker failures by converting transient errors into reproducible test cases. It automates the extraction of critical metadata from OpenTelemetry logs, including run IDs, worker IDs, and subprocess stdout, to build standardized JSONL recording fixtures. By generating Rust integration tests that mirror production runner behavior, this skill enables developers to isolate parsing bugs and execution errors, ensuring that fixes are verified against the exact conditions that caused the original failure.

Key Features

010 GitHub stars

02Support for multiple adapter types including Codex and Claude

03Rust-based integration test scaffolding for bug reproduction

04Automated extraction of failure metadata from Gardener TUI error blocks

05OpenTelemetry log parsing for run ID and subprocess stdout reconstruction

06JSONL recording fixture generation for deterministic session playback

Use Cases

01Creating regression tests for complex JSON parsing failures in adapter streams

02Debugging Gardener runtime issues using deterministic session snapshots

03Reproducing intermittent 'process error' bugs in distributed workers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add carterbs/gardener session-replay

For use in Claude.ai and ChatGPT