You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
CommandTree scans a VS Code workspace and surfaces all runnable tasks in a single tree view sidebar panel. It discovers shell scripts, npm scripts, Makefile targets, VS Code tasks, launch configurations, etc then presents them in a categorized, filterable tree.
44
+
CommandTree scans a VS Code workspace and surfaces all runnable commands in a single tree view sidebar panel. It discovers shell scripts, npm scripts, Makefile targets, VS Code tasks, launch configurations, etc then presents them in a categorized, filterable tree.
45
45
46
-
## Task Discovery
47
-
**task-discovery**
46
+
## Command Discovery
47
+
**command-discovery**
48
48
49
-
CommandTree recursively scans the workspace for runnable tasks grouped by type. Discovery respects exclude patterns configured in settings. It does this in the background on low priority.
49
+
CommandTree recursively scans the workspace for runnable commands grouped by type. Discovery respects exclude patterns configured in settings. It does this in the background on low priority.
50
50
51
51
### Shell Scripts
52
-
**task-discovery/shell-scripts**
52
+
**command-discovery/shell-scripts**
53
53
54
54
Discovers `.sh` files throughout the workspace. Supports optional `@param` and `@description` comments for metadata.
55
55
56
56
### NPM Scripts
57
-
**task-discovery/npm-scripts**
57
+
**command-discovery/npm-scripts**
58
58
59
59
Reads `scripts` from all `package.json` files, including nested projects and subfolders.
60
60
61
61
### Makefile Targets
62
-
**task-discovery/makefile-targets**
62
+
**command-discovery/makefile-targets**
63
63
64
64
Parses `Makefile` and `makefile` for named targets.
65
65
66
66
### Launch Configurations
67
-
**task-discovery/launch-configurations**
67
+
**command-discovery/launch-configurations**
68
68
69
69
Reads debug configurations from `.vscode/launch.json`.
70
70
71
71
### VS Code Tasks
72
-
**task-discovery/vscode-tasks**
72
+
**command-discovery/vscode-tasks**
73
73
74
74
Reads task definitions from `.vscode/tasks.json`, including support for `${input:*}` variable prompts.
75
75
76
76
### Python Scripts
77
-
**task-discovery/python-scripts**
77
+
**command-discovery/python-scripts**
78
78
79
79
Discovers files with a `.py` extension.
80
80
81
-
## Task Execution
82
-
**task-execution**
81
+
## Command Execution
82
+
**command-execution**
83
83
84
-
Tasks can be executed three ways via inline buttons or context menu.
84
+
Commands can be executed three ways via inline buttons or context menu.
85
85
86
86
### Run in New Terminal
87
-
**task-execution/new-terminal**
87
+
**command-execution/new-terminal**
88
88
89
-
Opens a new VS Code terminal and runs the task command. Triggered by the play button or `commandtree.run` command.
89
+
Opens a new VS Code terminal and runs the command. Triggered by the play button or `commandtree.run` command.
90
90
91
91
### Run in Current Terminal
92
-
**task-execution/current-terminal**
92
+
**command-execution/current-terminal**
93
93
94
-
Sends the task command to the currently active terminal. Triggered by the circle-play button or `commandtree.runInCurrentTerminal` command.
94
+
Sends the command to the currently active terminal. Triggered by the circle-play button or `commandtree.runInCurrentTerminal` command.
95
95
96
96
### Debug
97
-
**task-execution/debug**
97
+
**command-execution/debug**
98
98
99
-
Launches the task using the VS Code debugger. Only applicable to launch configurations. Triggered by the bug button or `commandtree.debug` command.
99
+
Launches the command using the VS Code debugger. Only applicable to launch configurations. Triggered by the bug button or `commandtree.debug` command.
100
100
101
-
## Quick Tasks
102
-
**quick-tasks**
101
+
## Quick Launch
102
+
**quick-launch**
103
103
104
-
Users can star tasks to pin them in a "Quick Tasks" panel at the top of the tree view. Starred task identifiers are persisted in the `quick` array inside `.vscode/commandtree.json`:
104
+
Users can star commands to pin them in a "Quick Launch" panel at the top of the tree view. Starred command identifiers are persisted in the `quick` array inside `.vscode/commandtree.json`:
105
105
106
106
```json
107
107
{
@@ -115,7 +115,7 @@ Users can star tasks to pin them in a "Quick Tasks" panel at the top of the tree
115
115
## Tagging
116
116
**tagging**
117
117
118
-
Tags group related tasks for organization and filtering.
118
+
Tags group related commands for organization and filtering.
119
119
120
120
### Tag Configuration File
121
121
**tagging/config-file**
@@ -132,7 +132,7 @@ Tags are defined in `.vscode/commandtree.json` under the `tags` key:
132
132
}
133
133
```
134
134
135
-
This file can be committed to version control to share task organization with a team.
135
+
This file can be committed to version control to share command organization with a team.
136
136
137
137
### Pattern Syntax
138
138
**tagging/pattern-syntax**
@@ -141,19 +141,19 @@ This file can be committed to version control to share task organization with a
141
141
|---------|---------|
142
142
|`npm:build`| Exact match: npm script named "build" |
143
143
|`npm:test*`| Wildcard: npm scripts starting with "test" |
144
-
|`*deploy*`| Any task with "deploy" in the name |
144
+
|`*deploy*`| Any command with "deploy" in the name |
145
145
|`type:shell:*`| All shell scripts |
146
146
|`type:npm:*`| All npm scripts |
147
147
|`type:make:*`| All Makefile targets |
148
148
|`type:launch:*`| All launch configurations |
149
-
|`**/scripts/**`| Path matching: tasks in any `scripts` folder |
150
-
|`shell:/full/path:name`| Exact task identifier (used internally for Quick Tasks) |
149
+
|`**/scripts/**`| Path matching: commands in any `scripts` folder |
150
+
|`shell:/full/path:name`| Exact command identifier (used internally for Quick Launch) |
151
151
152
152
### Managing Tags
153
153
**tagging/management**
154
154
155
-
-**Add tag to task**: Right-click a task > "Add Tag" > select existing or create new
156
-
-**Remove tag from task**: Right-click a task > "Remove Tag"
155
+
-**Add tag to command**: Right-click a command > "Add Tag" > select existing or create new
156
+
-**Remove tag from command**: Right-click a command > "Remove Tag"
@@ -162,20 +162,20 @@ This file can be committed to version control to share task organization with a
162
162
### Text Filter
163
163
**filtering/text**
164
164
165
-
Free-text filter via toolbar or `commandtree.filter` command. Matches against task names.
165
+
Free-text filter via toolbar or `commandtree.filter` command. Matches against command names.
166
166
167
167
### Tag Filter
168
168
**filtering/tag**
169
169
170
-
Pick a tag from the toolbar picker (`commandtree.filterByTag`) to show only tasks matching that tag's patterns.
170
+
Pick a tag from the toolbar picker (`commandtree.filterByTag`) to show only commands matching that tag's patterns.
171
171
172
172
### Clear Filter
173
173
**filtering/clear**
174
174
175
175
Remove all active filters via toolbar button or `commandtree.clearFilter` command.
176
176
177
-
## Parameterized Tasks
178
-
**parameterized-tasks**
177
+
## Parameterized Commands
178
+
**parameterized-commands**
179
179
180
180
Shell scripts with parameter comments prompt the user for input before execution:
181
181
@@ -197,35 +197,35 @@ All settings are configured via VS Code settings (`Cmd+,` / `Ctrl+,`).
197
197
### Exclude Patterns
198
198
**settings/exclude-patterns**
199
199
200
-
`commandtree.excludePatterns` - Glob patterns to exclude from task discovery. Default includes `**/node_modules/**`, `**/.vscode-test/**`, and others.
200
+
`commandtree.excludePatterns` - Glob patterns to exclude from command discovery. Default includes `**/node_modules/**`, `**/.vscode-test/**`, and others.
201
201
202
202
### Sort Order
203
203
**settings/sort-order**
204
204
205
-
`commandtree.sortOrder` - How tasks are sorted within categories:
205
+
`commandtree.sortOrder` - How commands are sorted within categories:
206
206
207
207
| Value | Description |
208
208
|-------|-------------|
209
209
|`folder`| Sort by folder path, then alphabetically (default) |
210
-
|`name`| Sort alphabetically by task name |
211
-
|`type`| Sort by task type, then alphabetically |
210
+
|`name`| Sort alphabetically by command name |
211
+
|`type`| Sort by command type, then alphabetically |
212
212
213
213
### Show Empty Categories
214
214
**settings/show-empty-categories**
215
215
216
-
`commandtree.showEmptyCategories` - Whether to display category nodes that contain no discovered tasks.
216
+
`commandtree.showEmptyCategories` - Whether to display category nodes that contain no discovered commands.
217
217
218
218
## User Data Storage
219
219
**user-data-storage**
220
220
221
-
CommandTree stores workspace-specific data in `.vscode/commandtree.json`. This file is automatically created and updated as you use the extension. It holds both quick task pins and tag definitions.
221
+
CommandTree stores workspace-specific data in `.vscode/commandtree.json`. This file is automatically created and updated as you use the extension. It holds both Quick Launch pins and tag definitions.
222
222
223
223
---
224
224
225
225
## Semantic Search (FUTURE FEATURE)
226
226
**semantic-search**
227
227
228
-
> **⏳ FUTURE FEATURE** — This section describes a planned feature that is **not currently being implemented**. It is included here for design reference only.
228
+
> **FUTURE FEATURE** — This section describes a planned feature that is **not currently being implemented**. It is included here for design reference only.
229
229
230
230
### Overview
231
231
**semantic-search/overview**
@@ -256,7 +256,7 @@ The summarisation interface is provider-agnostic — any model that accepts a te
256
256
### Database and Config Migration
257
257
**semantic-search/database-migration**
258
258
259
-
All workspace configuration currently stored in `.vscode/commandtree.json` (quick task pins, tag definitions) will migrate into a **local embedded database** (e.g. SQLite). This database also stores script summaries and vector embeddings.
259
+
All workspace configuration currently stored in `.vscode/commandtree.json` (Quick Launch pins, tag definitions) will migrate into a **local embedded database** (e.g. SQLite). This database also stores script summaries and vector embeddings.
260
260
261
261
The migration is automatic and transparent. The `.vscode/commandtree.json` file is read once during migration, and the database becomes the single source of truth going forward.
262
262
@@ -265,18 +265,18 @@ The migration is automatic and transparent. The `.vscode/commandtree.json` file
265
265
266
266
```mermaid
267
267
erDiagram
268
-
TaskRecord {
268
+
CommandRecord {
269
269
string scriptPath PK "Absolute path to the script"
270
270
string contentHash "Hash of script content (for change detection)"
0 commit comments