@kody/trello
Read and update Trello boards, lists, cards, and comments with dry-run mutations.
Files
@kody/trello — agent notes
Human setup and intent live in README.md. This file is for
agents: imports, smoke/dryRun execute snippets, and edge cases. Secrets by
name only — never paste key or token values. Do not disable or enable live
jobs unless the operator asks — the bundled account-health job stays
enabled: false unless they turn it on after a fork.
Auth
| Lane | Credential |
|---|---|
| API key + token | trelloApiKey + trelloToken (or *-<purpose>) |
| OAuth | integration trello / trello-<purpose> |
Host: api.trello.com. Multi-account: account: 'work' → trello-work /
trelloApiKey-work + trelloToken-work, or pass integrationName /
secretName / apiKeySecretName / auth: 'keyToken'|'oauth' explicitly.
Import paths
| Export | Import |
|---|---|
root dispatcher (default smoke-test) | kody:@kody/trello |
| accounts | kody:@kody/trello/accounts |
| viewer | kody:@kody/trello/viewer |
| boards | kody:@kody/trello/boards |
| lists | kody:@kody/trello/lists |
| cards | kody:@kody/trello/cards |
| comments | kody:@kody/trello/comments |
| request | kody:@kody/trello/request |
| smoke-test | kody:@kody/trello/smoke-test |
| scheduled-account-health | kody:@kody/trello/scheduled-account-health |
| types | kody:@kody/trello/types |
Prefer static kody:@kody/trello/... imports from execute. Do not lead with
packages.invoke.
Smoke test (read-only)
import smokeTest from 'kody:@kody/trello/smoke-test'
export default async function main() {
return await smokeTest()
// Without credentials: dry-run self-check + setup URLs
// With key/token or OAuth: live member + boards sample — no writes
}Equivalent via root dispatcher:
import trello from 'kody:@kody/trello'
export default async function main() {
return await trello({ action: 'smoke-test' })
}dryRun / confirm
Pass dryRun: true on writes to return { dryRun: true, method, path, body }
without contacting Trello. Live writes throw unless confirm: true.
import { createCard } from 'kody:@kody/trello/cards'
export default async function main() {
return await createCard({
listId: 'list-id-from-caller',
name: 'Write the release notes',
dryRun: true,
})
}Edge cases
- Board ids, list ids, and card ids come from the call. This package has no default board.
- Prefer Lane A (API key + token). Lane B OAuth 2 is not generally available
from Atlassian yet; only use a saved
trellointegration when one already exists. - Do not enable the
account-healthjob on the official listing; after a fork, enable only if the operator wants the weekly read. - Keep
LICENSE(MIT),## Intent, andcommunity-icon.svgfor community listing.