Trello Integration

Trello as an optional PM provider

Status in v3

Trello is an optional PM provider. pm.provider defaults to none, and pm.provider: trello remains a valid value. The Trello-specific tooling is retired: the trello license feature no longer exists under any tier, and the trello and ttask command groups print a retirement notice instead of running. Upgrading your license does not restore them.

Using any PM provider, including Trello, requires a Team or Enterprise license (the pm_basic feature gates the pm commands). It is not available on Free.

What happens to your config on upgrade

  • An existing trello: section (for example board_id) and your pm: section are preserved as you wrote them. Upgrade does not remove them.
  • Config validation requires the trello: section only when pm.provider is trello. Projects on any other provider, or on none, are not asked to add it.
  • The legacy sync_trello hook is stripped on upgrade. Its replacement is sync_pm.

Using Trello as the provider

yaml
# .paircoder/config.yaml
pm:
  provider: trello

trello:
  board_id: "your-board-id"

With the provider selected, work with cards through the provider-agnostic pm commands:

bash
# Show the resolved PM workflow configuration
bpsai-pair pm config

# Check the provider connection
bpsai-pair pm diagnostics

# Move, comment on, and complete work items
bpsai-pair pm move <item-id> --status in_progress
bpsai-pair pm comment <item-id> "50% complete"
bpsai-pair pm done <item-id> --summary "Implemented feature X"
bpsai-pair pm block <item-id> --reason "Waiting for API"

# Sync a plan's tasks to the board
bpsai-pair plan sync-pm my-plan --dry-run
bpsai-pair plan sync-pm my-plan --board <board-id>

Complete local tasks with bpsai-pair task update <id> --status done in every case; it works with any provider, including none. The provider reads its credentials from the TRELLO_API_KEY and TRELLO_TOKEN environment variables; set both before using it. See the Trello Integration section of the environment variables reference for where to get each value.

Retired commands and their replacements

RetiredUse instead
ttask listtask list
ttask showNo direct replacement; see the PM integration guide
ttask start, ttask movepm move <item-id> --status ...
ttask donepm done, or task update --status done
ttask blockpm block
ttask commentpm comment
ttask check / uncheckpm check
plan sync-trello (deprecated alias)plan sync-pm
trello connect, boards, use-board, status, sync, and the rest of the trello grouppm config, pm diagnostics, and the trello: config section

See PM integration for the provider model and the CLI reference for every command.