Task Cards

Task Cards turns tasks declared in each workspace folder's .vscode/tasks.json into compact, searchable cards in a dedicated VS Code Activity Bar view.

Get started · Contribute · Support · Security

Features

• Run a task by clicking anywhere on its card.
• Run every task in a folder, including subfolders, in tasks.json order; the sequence stops after the first failure and blocks overlapping card launches.
• Exclude individual tasks from folder runs and order previews with skipFolderRun.
• Stop a running task directly from its card.
• Show the final folder layout with skeleton cards until VS Code finishes resolving runnable tasks.
• Refresh cards automatically when .vscode/tasks.json is saved or changed externally.
• Right-click a card to open its exact definition in tasks.json.
• Organize configured tasks into slash-separated nested folders.
• Add an emoji or short text icon to each configured task.
• Require confirmation for sensitive launches.
• Search task names, details, types, folders, and workspace names.
• Keep a stable two-column grid that adapts to one column in narrow sidebars.
• Work with multi-root, local, and remote workspaces.
• Browse task definitions safely in Restricted Mode; execution remains disabled until the workspace is trusted.

Installation

After Marketplace publication, search for Task Cards in the VS Code Extensions view or run:

code --install-extension DiogoRibeiro.task-cards

For local testing, open the Extensions view, select Views and More Actions… → Install from VSIX…, and choose the packaged task-cards-*.vsix file.

Getting started

Add a task-card entry to a workspace folder's .vscode/tasks.json:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Deploy production",
      "type": "task-card",
      "command": "npm",
      "args": ["run", "deploy"],
      "folder": "Deploy/Production",
      "icon": "🚀",
      "confirm": "Deploy the production environment?",
      "detail": "Publishes the current release"
    }
  ]
}

Open Task Cards from the Activity Bar. Click a card to run it, or right-click it to open the corresponding JSON definition.

task-card properties

Standard VS Code fields such as options, presentation, problemMatcher, dependsOn, runOptions, and detail remain supported.

The folder, icon, skipFolderRun, and confirm properties are also read from ordinary configured task types such as shell and process; those tasks keep their native VS Code execution. These properties are extension-specific on built-in task types, so VS Code may show a schema warning for them. Use task-card when you want schema-provided completion for all Task Cards properties.

For shell execution, a command without args is treated as a complete shell command line, so operators such as pipes and && work normally. When args is supplied, VS Code safely constructs the command line from the executable and its arguments.

Ordinary configured task types are also displayed. Tasks without a folder appear under Ungrouped.

Scope and confirmation boundary

Only tasks explicitly declared in a workspace folder's .vscode/tasks.json are shown. Auto-detected package scripts, user tasks, and tasks defined only in a .code-workspace file are intentionally excluded.

Confirmation is enforced only when a task is launched from Task Cards. Folder runs show one confirmation dialog listing every included task's confirmation message. VS Code does not let this extension intercept every native execution path, so launches from Tasks: Run Task, keybindings, dependencies, or other extensions bypass Task Cards confirmation.

Task Cards targets official desktop VS Code, including remote workspaces. It has no browser extension entry, telemetry, or external network requests.

Contributing

Contributions are welcome. Start with the contributing guide, which documents the project philosophy, architecture, development setup, test expectations, and the changes that should be discussed before implementation.

For help, see Support. Report vulnerabilities through the private process in the Security policy. Maintainers can use the release and Marketplace checklist.

License

MIT