TaskLink - Collaborative In-Code Task Tracker

TaskLink is a VS Code extension that transforms inline TODO comments into a shared, real-time task board visible to all developers on a team. It provides a visual sidebar UI to create, track, update, and mark tasks as complete directly from the editor, with Git-based collaboration and no external servers.

Features

• Task Creation: Create tasks directly from the sidebar UI with a step-by-step form
• Inline Comments: Automatically adds TODO comments to specified files and lines
• Task Management: Edit, delete, and update task status directly from the tree view
• Status Tracking: Tasks can have TODO, IN_PROGRESS, REVIEW, and DONE statuses
• Assignment: Assign tasks to team members
• Author Tracking: Track who created each task
• Collaboration: All task data is stored in Git-tracked files for team collaboration
• Real-time Updates: Tasks are automatically synchronized across team members through Git

Installation

From Visual Studio Marketplace (Recommended)

1. Open Visual Studio Code
2. Go to the Extensions view (Ctrl+Shift+X)
3. Search for "TaskLink"
4. Click "Install"

From Source (Development)

1. Clone this repository to your local machine
2. Open the project in VS Code
3. Run npm install to install dependencies
4. Press F5 to launch the extension in a new Extension Development Host window

Usage

Creating Tasks

1. Click the "Add Task" button in the TaskLink sidebar
2. Fill in the task details in the step-by-step form
3. The task will be added to the appropriate status section
4. An inline comment will be added to the specified file

Managing Tasks

• Right-click on any task to access the context menu with options to:
  • Edit Task
  • Delete Task
  • Change Task Status
  • Assign Task
• Click on a task to open the associated file at the correct line

Setting Default Author

• Click "Set Default Author" in the TaskLink sidebar to set your name for all tasks
• This will be used as the author for all tasks you create

Refreshing Tasks

• Click the refresh button in the TaskLink sidebar to manually refresh the task list

File Structure

• Task data is stored in .vscode/team_tasks.json in each project
• Inline comments are added directly to your source code files
• All data is version-controlled through Git

Collaboration Workflow

1. Each team member installs the extension
2. Tasks are created and managed directly in the code
3. Task data is automatically saved to .vscode/team_tasks.json
4. Team members commit and push changes to Git
5. Other team members pull changes to see updated tasks
6. All team members have access to the same task board

For detailed information on team collaboration, see TEAM_COLLABORATION.md.

Requirements

• VS Code version 1.74.0 or higher
• Git for version control

Development

Building the Extension

npm run compile

Running the Extension

Press F5 in VS Code to launch the extension in a new Extension Development Host window.

Packaging the Extension

npm install -g vsce
vsce package

Publishing the Extension

vsce login KaweeshaNethmina
vsce publish

For detailed information on the project structure, see PROJECT_STRUCTURE.md.

For information on publishing the extension, see PUBLISHING.md.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License.