Trello Integration
Trello as an optional PM provider
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 exampleboard_id) and yourpm:section are preserved as you wrote them. Upgrade does not remove them. - Config validation requires the
trello:section only whenpm.provideristrello. Projects on any other provider, or onnone, are not asked to add it. - The legacy
sync_trellohook is stripped on upgrade. Its replacement issync_pm.
Using Trello as the provider
# .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:
# 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
| Retired | Use instead |
|---|---|
ttask list | task list |
ttask show | No direct replacement; see the PM integration guide |
ttask start, ttask move | pm move <item-id> --status ... |
ttask done | pm done, or task update --status done |
ttask block | pm block |
ttask comment | pm comment |
ttask check / uncheck | pm check |
plan sync-trello (deprecated alias) | plan sync-pm |
trello connect, boards, use-board, status, sync, and the rest of the trello group | pm config, pm diagnostics, and the trello: config section |
See PM integration for the provider model and the CLI reference for every command.