Skip to content
← Public packages

@cameronpak/raycast-kodys-pouch

Your Kody Skills and Tools, one command away.

AGENTS.md

22 lines · 1.5 KB · Markdown

Pouch Discovery Package

This Package is the HTTPS bridge for Kody's Pouch. Keep it fork-safe.

Skills

  • Resolve the caller's skills Package with kody.packageList({}) and kody_id === "skills".
  • Load skill-list and skill-get with a computed import(specifier) built from that Package's scoped name.
  • Do not replace the computed import with a static kody:@cameronpak/skills import. A static transitive dependency loses storage provenance when an agent imports this Package and pins forks to Cam's account.
  • Do not restore packages.invoke. Kody Gate 2 replaced author-facing invoke with computed imports for runtime package names.

Webhooks

  • The Raycast extension uses the pouch sync, params webhook. Its closed operation union delegates only to the five read-only Pouch exports; do not turn it into an arbitrary export router.
  • Keep the five same-named webhook declarations until installs configured before the one-URL migration have moved to pouch. New installs mint only pouch; remove the legacy declarations after that migration window.
  • A webhook URL is a credential. Owners mint and reveal it only in Package Settings, then store it in a Raycast password preference.

Verify

  • Run package checks before publish.
  • After publish and mint, use webhookSyntheticDispatch for pouch, including all five operations.
  • Smoke-test list-skills and get-skill through an agent execute import of this Package to catch storage-provenance regressions.