Trello - Mirage

TrelloVFS exposes a Trello workspace as a tree of boards, lists, and cards. Setup steps for the API key/token live at Trello Credentials.

Node

pnpm add @struktoai/mirage-node

import { MountMode, TrelloVFS, Workspace } from '@struktoai/mirage-node'

const trello = new TrelloVFS({
  apiKey: process.env.TRELLO_API_KEY!,
  apiToken: process.env.TRELLO_API_TOKEN!,
})

const ws = new Workspace({ '/trello': trello }, { mode: MountMode.READ })
await ws.shell('ls /trello/')

Browser

pnpm add @struktoai/mirage-browser

import { MountMode, TrelloVFS, Workspace } from '@struktoai/mirage-browser'

const trello = new TrelloVFS({
  apiKey: TRELLO_API_KEY,
  apiToken: TRELLO_API_TOKEN,
})

Config

Field	Default	Notes
`apiKey`	required	Trello API key. Redacted in snapshots.
`apiToken`	required	Trello API token. Redacted in snapshots.
`workspaceId`	none	Restrict to a single workspace.
`boardIds`	none	Optional allowlist of board IDs.
`baseUrl`	`https://api.trello.com/1`	Override for Enterprise instances.

Mount mode

read. For board/list/card layout see the Python Trello docs.