Skip to content

aidenlx/zotlit / .agents/skills/zotero-rdp-debug

zotero-rdp-debug

Verified

Ground 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."

FileKindSize
SKILL.mdskill md2.5 KB
capture-server.mdmarkdown868 B

capture-server.md

View on GitHub
# Verify outbound HTTP notifications

When the plugin's job is to send something (the notify feature POSTs events to Obsidian),
inspecting internal state is insufficient — prove the bytes leave Zotero.

Run the capture server on the port the plugin targets (`extensions.zotlit.notify-url`,
default `9091`):

```bash
node apps/zotero/scripts/debug/capture-server.ts 9091 > .scratch/capture.log 2>&1 &
until rg -q "listening" .scratch/capture.log; do sleep 1; done
```

Trigger the behaviour via `packages/scripts/scripts/zotero-rdp.ts` and read `.scratch/capture.log`. Each `POST /notify` body
is logged with a timestamp — a line appearing is end-to-end proof the plugin dispatched; an
empty log means it did not (check prefs, enablement flags, and observer registration).

Stop the capture server when done:

```bash
pkill -f "scripts/debug/capture-server.ts"
```
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall