ossrules.md

control-kody

Drive and verify the Kody app with a Feature Map and one CLI. Use when changing UI, account routes, preview deploys, or proving a Cloud Agent change with a real origin, session, and /health SHA.

Install
npx skills add 'https://github.com/kentcdodds/kody/tree/main/.agents/skills/control-kody'
Download bundle ↓
main · 8beb6cd ↗Scanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

references/features/integrations.md

references/features/integrations.mdBrowse 27 files
View on GitHub
257 tokens

1,082 bytes
Token encoding: o200k_base
Snapshot 8beb6cd

← Back to SKILL.md

Integrations and OAuth connect

Saved OAuth connections and the hosted connect start.

How to get there

/account/integrations → /account/integrations/:integrationName. OAuth apps: /account/integrations/apps/:appSlug. One-click grant: /account/integrations/approve. Start connect: /connect/oauth.

Drive it

node tools/control-kody.ts request GET /account/integrations.json

APIs

  • GET|POST /account/integrations.json
  • /connect/oauth (browser; needs a real provider client)

Gotchas

  • Cloud Agents cannot complete a third-party OAuth dance without credentials in the environment. HTTP list/empty-state is the usual proof.
  • /docs/connect is the public how-to, not the account page.
  • OAuth access/refresh tokens and app client secrets live as AES-GCM ciphertext on user_integrations / user_oauth_apps, not as user secret-store rows.
  • After a successful /connect/oauth, the success page shows a What's next? prompt the user can copy into chat. Agents communitySearch (prefer trusted) or create a helpers package.
← All Kody skillsProject instructions →