trello-cli

A production-ready CLI for Trello, built with TypeScript and Node.js.

Setup

Requirements: Node.js 18+

npm install
npm run build
npm link   # makes `trello` available globally

Authenticate

trello login

You'll be prompted for your API key. The CLI will print a URL — open it to generate a token, paste it back, and credentials are saved securely in your OS keychain.

To get your API key: https://trello.com/power-ups/admin

Log out

trello logout

Commands

Boards

trello boards                    # List all open boards
trello boards search <query>     # Filter boards by name

Lists

trello lists <boardId>           # List all lists on a board

Cards

trello cards <listId>            # List cards in a list
trello card <cardId>             # Show card detail (name, desc, due, labels)

Create / Modify Cards

trello add card <listId> <name>               # Create a card
trello add card <listId> <name> --desc "..."  # With description
trello add card <listId> <name> --due 2024-12-31  # With due date

trello move <cardId> <listId>    # Move card to another list
trello archive <cardId>          # Archive a card

Flags

All commands support --json for machine-readable output:

trello boards --json
trello cards <listId> --json

Development

npm run dev          # tsx watch mode (hot reload)
npm run build        # rimraf dist && tsc

Project Structure

src/
  index.ts   — CLI entry point (commander setup)
  api.ts     — Trello REST API calls
  auth.ts    — keytar credential management
  output.ts  — table/JSON rendering
  types.ts   — Board, List, Card interfaces