Trello CLI

A Python command-line interface for managing Trello boards, cards, labels, and comments.

Features

• List all boards in your workspace
• Create cards with descriptions, labels, and comments
• Add labels and comments to existing cards
• View detailed board information (lists, labels, cards)
• Interactive prompts for user-friendly operation
• Rich terminal formatting with colors and tables

Installation

1. Clone the repository:

   git clone <repository-url>
   cd trello-cli

2. Install dependencies:

   pip install -r requirements.txt

3. Get Trello API credentials:

   • API Key: https://trello.com/app-key
   • Token: https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=TrelloCLI&key=YOUR_API_KEY

Configuration

Set environment variables (optional):

export TRELLO_API_KEY="your_api_key_here"
export TRELLO_TOKEN="your_token_here"

If not set, you'll be prompted when running commands.

Usage

python main.py [COMMAND] [OPTIONS]

Commands

List workspace boards:

python main.py workspace
python main.py workspace --verbose  # Show IDs

Create a card:

python main.py card create
# Interactive prompts for all fields

# Or with flags:
python main.py card create --board "My Board" --list "To Do" --title "New Task" --labels "red blue"

Add to existing card:

python main.py card add --board "My Board" --card "Task Name" --comment "Update" --label "green"

View board info:

python main.py board info --board "My Board"

Examples

Create a bug report:

python main.py card create \
  --board "Development" \
  --list "Backlog" \
  --title "Fix login issue" \
  --labels "red" \
  --comment "Urgent fix needed"

Testing

python -m unittest test_trello_cli.py -v

Note: Integration tests require valid Trello credentials.

Next Development Steps

• Migrate to Python Poetry for dependency management
• Implement card filtering and search functionality
• Add bulk operations for multiple cards
• Create configuration file support for default board/list
• Add export functionality (JSON, CSV)

Resources Used

• Typer Tutorial - CLI framework documentation
• Typer GitHub Issue #530 - Handling empty prompts as None
• Python CLI Tutorial - YouTube tutorial
• Trello REST API Documentation - Trello API reference