libretto-readonly
libretto-readonly lets you examine and diagnose the current state of any live browser session without altering the page or application. Built as part of Saffron Health's AI automation toolkit, it provides reliable inspection capabilities for debugging and understanding browser behavior in real time.
libretto-readonly lets you examine and diagnose the current state of any live browser session without altering the page or application. Built as part of Saffron Health's AI automation toolkit, libretto-readonly provides reliable inspection capabilities for debugging and understanding browser behavior in real time. It supports focused inspection queries like checking visibility, text content, and element counts, making it ideal for diagnosing issues without side effects.
AI-generated summary based on this skill's SKILL.md
Install
saffron-health/libretto/libretto-readonly · repository language: TypeScript
git clone https://github.com/saffron-health/libretto
cp -r libretto/.agents/skills/libretto-readonly ~/.claude/skills/libretto-readonlyFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is libretto-readonly and what can it do?
libretto-readonly lets you examine and diagnose the current state of any live browser session without altering the page or application. Built as part of Saffron Health's AI automation toolkit, libretto-readonly provides reliable inspection capabilities for debugging and understanding browser behavior in real time. It supports focused inspection queries like checking visibility, text content, and element counts, making it ideal for diagnosing issues without side effects.
Can I diagnose live browser state without clicking or modifying the page?
Yes. libretto-readonly is specifically designed to diagnose and inspect live browser state without making any changes to the page or application. You can view page content, DOM structure, and HTTP responses safely in read-only mode. This non-destructive browser inspection approach preserves the current state of your browser session, allowing you to understand what's happening without introducing unintended side effects.
How does libretto-readonly help debug failed browser automation jobs?
libretto-readonly enables you to debug failed browser automation jobs by connecting to an existing browser session in read-only mode. Once connected, you can view page content, DOM, and HTTP responses to diagnose what went wrong. This approach lets you inspect the exact state the browser was in when a job failed, making root-cause analysis faster and more reliable without risking further state changes.
What inspection queries can libretto-readonly perform?
libretto-readonly supports focused inspection queries including checking element visibility, extracting text content, counting elements, and examining DOM structure. These queries allow you to gather diagnostic information about your page state in a targeted way. Combined with access to console output and HTML snapshots, libretto-readonly gives you comprehensive visibility into browser behavior for effective debugging.
How do I connect to an existing browser session using libretto-readonly?
libretto-readonly lets you connect to an existing browser session in read-only mode to preserve its current state. This connection approach is designed for inspection workflows where you want to examine a live session without triggering any interactions or mutations. After diagnosis is complete, you can close the inspection session to avoid resource waste.
Is libretto-readonly free to use?
Yes, libretto-readonly is released under the MIT license, making it free and open source. You can use it for both personal and commercial projects without licensing restrictions. The MIT license provides full transparency and allows you to modify and distribute the tool as needed for your browser inspection and debugging workflows.
SKILL.md
rendered from the published skill — quoted content, verbatim
How Libretto Read-Only Works
- Use this skill when the browser session must stay strictly read-only.
- Libretto stores read-only vs write-access on the session itself.
- The primary inspection tools are
snapshotandreadonly-exec. readonly-execreuses Libretto's normal execution pipeline, but it only exposes read-only helpers and denies mutating Playwright methods.- Only a user can change the session mode for an existing session. Never change a session's mode on your own — the user must change it themselves manually.
Working Rules
- Announce which session you are using and what page you are inspecting.
- Do not use
exec,run, or any direct Playwright action that could change browser or application state. - Do not click, type, submit forms, navigate, upload files, dispatch DOM events, or send non-GET requests.
- Prefer
snapshotfirst when the visible page state is unclear. - Use
readonly-execfor focused inspection: titles,
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.agents/skills/libretto-readonly/SKILL.md