Almusanid Trello Checklist Manager

A Visual Studio Code extension that helps you manage your Trello checklists directly from your IDE. This extension automatically finds and displays Trello card checklists based on your current Git branch name.

Installation

VS Code

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Almusanid Trello Checklist Manager"
4. Click Install

Or install directly using:

ext install AhmedIbrahim.almusanid-trello-checklist-manager

Cursor

You can now use the extension in Cursor in two ways:

1. Import VS Code settings (Recommended):

   • Open Command Palette (Cmd/Ctrl + Shift + P)
   • Type and select "Import VS Code Settings"
   • The extension will be automatically installed and configured

2. Manual installation:

   • Download the latest .vsix file from the releases page
   • In Cursor, open the Command Palette (Cmd/Ctrl + Shift + P)
   • Type "Install from VSIX" and select the command
   • Choose the downloaded .vsix file

Features

🔍 Automatic Card Detection

• Automatically finds Trello cards that match your current Git branch name
• Requires cards to have the "branch" label for matching
• Shows all checklists associated with the matched card

📋 Task Management

• View all checklist items directly in VS Code
• Separate views for active and completed tasks
• Toggle task completion status with a single click
• Create new tasks directly from VS Code
• Tasks show assignee information with initials and full name on hover

👥 Member Integration

• Shows member assignments on tasks
• Displays member initials for quick identification
• Full member names available on hover

📊 Organization

• Each checklist is split into two sections:
  • Active tasks (uncompleted)
  • Completed tasks
• Clear task counts for each section
• Easy to distinguish between active and completed items

🔗 Trello Integration

• Open cards directly in Trello web interface
• Quick refresh to sync with Trello
• Seamless creation of new tasks

Setup

1. Install the extension from the VS Code marketplace

2. Get your Trello API credentials:

   • Get your API Key from: https://trello.com/app-key
   • Generate a Token from the same page

3. Configure the extension in VS Code settings:

   {
     "trelloChecklistManager.apiKey": "your-api-key",
     "trelloChecklistManager.token": "your-token",
     "trelloChecklistManager.projectMappings": {
       "your-repo-name": "your-board-id"
     }
   }
   

   To get your board ID:

   1. Open your Trello board in the browser
   2. Add .json to the URL
   3. Look for the id field in the JSON response

Usage

Viewing Tasks

1. Open a Git repository
2. The extension will automatically find a Trello card matching your branch name (must have "branch" label)
3. Tasks will appear in the Explorer sidebar under "Trello Checklist"

Managing Tasks

• Toggle Task Completion: Click the task or use the context menu
• Create New Task: Right-click on a checklist and select "Create New Task"
• Open in Browser: Right-click any task or checklist and select "Open in Trello"
• Refresh View: Click the refresh icon in the view's title bar

Task Organization

• Active tasks appear under the checklist name
• Completed tasks appear under "[Checklist Name] (Completed)"
• Each section shows the count of tasks

Requirements

• VS Code version 1.101.0 or higher
• Git repository
• Trello board with cards that:
  • Match your branch names
  • Have the "branch" label
  • Contain checklists

Known Issues

• The extension requires cards to have the "branch" label for matching
• Card names must exactly match branch names (case-insensitive)

Release Notes

0.0.7

• Moved to Explorer view for better visibility
• Added "Open in Trello" functionality
• Added create task feature
• Improved task organization with separate completed tasks view
• Enhanced member information display

0.0.6

• Initial release with basic checklist functionality

Contributing

Found a bug or have a feature request? Please open an issue on the GitHub repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.