trello-cli

A Rust CLI for Trello, optimized for AI agents.

Usage

trello login [--api-key <KEY>] [--api-token <TOKEN>]
trello card create <LIST> <NAME> [-d <DESC>] [-p <POSITION>] [-b <BOARD>]
trello card update <CARD_ID> [-d <DESC>] [-l <LABEL>]... [--clear-label <LABEL>]... [-c <TEXT>] [-a] [-r]
trello card move <CARD_ID> <POSITION>
trello card delete <CARD_ID>
trello card find <PATTERN> [-b <BOARD>] [-l <LIST>] [--json]
trello card show <CARD_ID> [--json] [--comments]
trello board show <BOARD_ID> [--json]
trello list show <LIST_ID> [--json]
trello list move <LIST_ID> <POSITION>

Position values: top, bottom, or a numeric value.

Configuration

Get an API key from https://trello.com/power-ups/admin and generate a token for it.

Option 1: Login command

trello login

This prompts for your API key and token interactively (the token is hidden during input) and saves them to the config file. You can also pass them as flags:

trello login --api-key YOUR_KEY --api-token YOUR_TOKEN

Option 2: Environment variables

export TRELLO_API_KEY="your_api_key"
export TRELLO_API_TOKEN="your_api_token"

Environment variables take precedence over the config file when both are set.

Development

Clone the repository:

git clone https://github.com/RKeelan/trello-cli.git
cd trello-cli

Build:

cargo build

Test:

cargo test

Format and lint:

cargo fmt --all && cargo clippy --fix --all-targets -- -D warnings

Run:

cargo run -- --help

Install from source:

cargo install --path .

This installs the trello binary to ~/.cargo/bin/. Ensure this directory is in your PATH.