| name | latchkey |
| description | Interact with third-party services (Slack, Discord, Dropbox, GitHub, Linear...) on user's behalf using their public APIs. |
Latchkey
Instructions
Latchkey is a CLI tool that automatically injects credentials into curl commands for supported public APIs. Instead of manually managing API tokens, latchkey opens a browser for login, extracts credentials from the session, and injects them into your curl requests.
Use this skill when the user asks you to work with third-party services like Slack, Discord, Dropbox, Github, Linear and others on their behalf.
Usage:
- Use
latchkey curl instead of regular curl for supported services.
- Look for the newest documentation of the desired public API online.
- Pass through all regular curl arguments - latchkey is a transparent wrapper.
- Use
latchkey status <service_name> when you notice potentially expired credentials.
- When the status is
invalid, force a new login by calling latchkey clear <service_name>, then retry the curl command.
- Do not force a new login if the status is
valid - the user might just not have the necessary permissions.
Examples
Make an authenticated curl request
latchkey curl [curl arguments]
Creating a Slack channel
latchkey curl -X POST 'https://slack.com/api/conversations.create' \
-H 'Content-Type: application/json' \
-d '{"name":"my-channel"}'
(Notice that -H 'Authorization: Bearer is not present in the invocation.)
Getting Discord user info
latchkey curl 'https://discord.com/api/v10/users/@me'
Clear expired credentials and force a new login to Discord
latchkey status discord
latchkey clear discord
latchkey curl 'https://discord.com/api/v10/users/@me'
Only do this when you notice that your previous call ended up not being authenticated (HTTP 401 or 403). The next latchkey curl call will trigger a new login flow.
List supported services
latchkey services
Notes
- All curl arguments are passed through unchanged
- Return codes, stdin, and stdout are passed back from curl
