Workspace Tasks

A powerful Visual Studio Code extension that automatically discovers, organizes, and runs tasks from your workspace. Manage build scripts, run tests, execute workflows, and organize your development tasks with favorites and compound tasks — all from a single, intuitive interface.

---

Screenshots

---

Key Features

• 🔍 Automatic Task Discovery — Scans your workspace for tasks from 20+ file types and build systems
• 📍 Flexible Placement — View tasks in the dedicated sidebar or as a dockable panel in the Explorer
• ⭐ Favorites — Pin frequently used tasks for instant access
• 🌱 Recent Tasks — Tracks the most recently executed tasks
• 📋 Multiple Compound Tasks (Queues) — Create and manage named sequences of tasks
• ▶️ Quick Execution — Double-click tasks to run instantly, or use the play icon (▶️)
• 🎯 Smart Organization — Hierarchical tree view organized by workspace, task type, and file
• 🔀 Drag & Drop — Reorder tasks in Compound Tasks (Queues) with drag and drop
• 🎭 GitHub Actions Support — Run GitHub Actions workflows locally with act
• 📝 Custom Tasks — Define reusable task templates with dynamic inputs
• 🚫 Task Filtering — Use .tasksignore files to exclude unwanted tasks
• 🙈 Hide Tasks & Groups — Hide individual tasks or entire task groups from view
• 💾 Persistent State — Favorites and Compound Tasks (Queues) are saved across Visual Studio Code sessions
• ☁️ Settings Sync — Sync your favorites and Compound Tasks (Queues) across multiple machines via VS Code’s Settings Sync

---

Installation

From Visual Studio Code Marketplace

1. Open Visual Studio Code
2. Go to the Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for “Workspace Tasks”
4. Click Install

→ Visual Studio Marketplace

From Open VSX Registry

For editors that use the Open VSX Registry (e.g., Cursor, VSCodium):

1. Open your editor
2. Go to the Extensions view (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for “Workspace Tasks”
4. Click Install

→ Open VSX Registry

From Command Line

Choose the command based on your editor

code --install-extension darthminos.workspace-tasks

cursor --install-extension darthminos.workspace-tasks

codium --install-extension darthminos.workspace-tasks

antigravity --install-extension darthminos.workspace-tasks

kiro --install-extension darthminos.workspace-tasks

windsurf --install-extension darthminos.workspace-tasks

See Getting Started for more installation options.

---

Quick Start

1. Open a workspace with supported task files (e.g., package.json, Makefile, shell scripts)
2. Open the Workspace Tasks view from the Activity Bar (sidebar) or Explorer panel
3. Browse tasks organized by workspace folder and task type
4. Run a task by double-clicking it or clicking the play icon (▶️)
5. Add to favorites by clicking the star icon (☆)
6. Create a Compound Task (Queue) by clicking the list icon to organize task sequences

See the Getting Started guide for full installation and setup instructions.

---

Documentation

Section	Description
Getting Started	Installation and initial setup
Supported Task Types	All supported build tools and frameworks
Favorites & Recent Tasks	Pin and track frequently used tasks
Compound Tasks (Queues)	Create sequences of tasks to run in order
Hide Tasks & Groups	Declutter your task view
Task History	Track and review all task executions
GitHub Actions Integration	Run workflows locally with act
Configuration	Full settings reference
Task Filtering	Exclude files using .tasksignore
.tasksignore Reference	.tasksignore file format and syntax
Custom Workspace Tasks	Define reusable task templates
Requirements	System requirements and tool dependencies
Contributing	How to contribute to the project
Troubleshooting	Diagnose and resolve common issues