aidenlx/zotlit / .agents/skills/zotero-rdp-debug
zotero-rdp-debug
VerifiedGround truth from the running Zotero plugin over RDP. Use to inspect Zotero runtime state, to diagnose an observer or notifier that misfires, or to verify the plugin's outbound HTTP notifications. Also covers "debug the plugin" or "check it in Zotero."
Debug the Zotero plugin over RDP
Source tells you what should happen; the running app tells you what does. Evaluate in
Zotero's parent process with packages/scripts/scripts/zotero-rdp.ts (written zotero-rdp.ts
below), run from the repo root.
- Contract — run
zotero-rdp.ts --help. Done when you know how it finds the port, how to write a sync and an async expression, and what its exit codes mean. - Paired Run — reuse a running one: the Fixture database admits one Zotero, so a second
launch fails. Otherwise start one in the background — it keeps running after readiness
(prerequisites:
docs/fixture.md, "Run a Paired Run"):pnpm fixture dev --for <duration> > .scratch/fixture-dev.log 2>&1 &. It holds a Desktop Slot for that Lease (up to 60 min), so it also wraps the walk; exit 75 in the log means blocked by the holder it names. Done whenzotero-rdp.ts 'Zotero.version'prints a version — the Fixture's Zotero, which can differ from the source checkout. - Probe — evaluate until the runtime answers your question. Eval can also drive the app (open readers, select tabs, save items) and fires the same notifiers and observers as a user action does.
- Stop — once the question is answered, stop a Paired Run you started. Send SIGINT to
the whole process group of
pnpm fixture dev, asCtrl-Cdoes:kill -INT -- -<pgid>. SIGINT to the innerfixture.tsprocess alone leaves the run and its Zotero up. Close a Paired Zotero thatpnpm fixture openstarted withpnpm fixture stop. Leave a reused run up. Done whenzotero-rdp.ts 'Zotero.version'reports no live Paired Run.
Gotchas
Zotero.Prefs.getprependsextensions.zotero.unless the second argument istrue.Zotero.Prefs.get("extensions.zotlit.notify")returnsundefined; useZotero.Prefs.get("extensions.zotlit.notify", true).- Notifier types are validated. An unknown type string throws. When an observer never
fires, confirm in the Zotero source that
Zotero.Notifier.triggerruns for that event and type.
Outbound HTTP
When the question is whether a notification leaves Zotero, follow capture-server.md.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |