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
Copy file name to clipboardExpand all lines: README.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
-
# TaskTree
1
+
# CommandTree
2
2
3
3
One sidebar. Every task in your workspace.
4
4
5
-
TaskTree scans your project and surfaces all runnable tasks in a single tree view: shell scripts, npm scripts, Makefile targets, VS Code tasks, launch configurations, and Python scripts. Filter by text or tag, run in terminal or debugger.
5
+
CommandTree scans your project and surfaces all runnable tasks in a single tree view: shell scripts, npm scripts, Makefile targets, VS Code tasks, launch configurations, and Python scripts. Filter by text or tag, run in terminal or debugger.
6
6
7
7
## Features
8
8
9
9
-**Auto-discovery** - Shell scripts (`.sh`, `.bash`, `.zsh`), npm scripts, Makefile targets, VS Code tasks, launch configurations, and Python scripts
10
10
-**Quick Tasks** - Pin frequently-used tasks to a dedicated panel at the top
11
-
-**Tagging** - Auto-tag tasks by type, label, or exact ID using pattern rules in `.vscode/tasktree.json`
11
+
-**Tagging** - Auto-tag tasks by type, label, or exact ID using pattern rules in `.vscode/commandtree.json`
12
12
-**Filtering** - Filter the tree by text search or by tag
13
13
-**Run anywhere** - Execute in a new terminal, the current terminal, or launch with the debugger
14
14
-**Folder grouping** - Tasks grouped by directory with collapsible nested hierarchy
@@ -33,10 +33,10 @@ Install from the VS Code Marketplace, or from source:
33
33
```bash
34
34
npm install
35
35
npm run package
36
-
code --install-extension tasktree-*.vsix
36
+
code --install-extension commandtree-*.vsix
37
37
```
38
38
39
-
Open a workspace and the TaskTree panel appears in the sidebar. All discovered tasks are listed by category.
39
+
Open a workspace and the CommandTree panel appears in the sidebar. All discovered tasks are listed by category.
40
40
41
41
## Usage
42
42
@@ -46,18 +46,18 @@ Open a workspace and the TaskTree panel appears in the sidebar. All discovered t
46
46
-**Star a task** - Click the star icon to pin it to Quick Tasks
47
47
-**Filter** - Use the toolbar icons to filter by text or tag
48
48
-**Tag tasks** - Right-click > "Add Tag" to group related tasks
49
-
-**Edit tags** - Configure auto-tagging patterns in `.vscode/tasktree.json`
49
+
-**Edit tags** - Configure auto-tagging patterns in `.vscode/commandtree.json`
50
50
51
51
## Settings
52
52
53
53
| Setting | Description | Default |
54
54
|---------|-------------|---------|
55
-
|`tasktree.excludePatterns`| Glob patterns to exclude from discovery |`**/node_modules/**`, `**/.git/**`, etc. |
56
-
|`tasktree.sortOrder`| Sort tasks by `folder`, `name`, or `type`|`folder`|
55
+
|`commandtree.excludePatterns`| Glob patterns to exclude from discovery |`**/node_modules/**`, `**/.git/**`, etc. |
56
+
|`commandtree.sortOrder`| Sort tasks by `folder`, `name`, or `type`|`folder`|
57
57
58
58
## Tag Configuration
59
59
60
-
Create `.vscode/tasktree.json` to define tag patterns:
60
+
Create `.vscode/commandtree.json` to define tag patterns:
Copy file name to clipboardExpand all lines: SPEC.md
+22-22Lines changed: 22 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# TaskTree Specification
1
+
# CommandTree Specification
2
2
3
3
## Table of Contents
4
4
@@ -41,12 +41,12 @@
41
41
## Overview
42
42
**overview**
43
43
44
-
TaskTree 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 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.
45
45
46
46
## Task Discovery
47
47
**task-discovery**
48
48
49
-
TaskTree 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 tasks 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
52
**task-discovery/shell-scripts**
@@ -86,22 +86,22 @@ Tasks can be executed three ways via inline buttons or context menu.
86
86
### Run in New Terminal
87
87
**task-execution/new-terminal**
88
88
89
-
Opens a new VS Code terminal and runs the task command. Triggered by the play button or `tasktree.run` command.
89
+
Opens a new VS Code terminal and runs the task command. Triggered by the play button or `commandtree.run` command.
90
90
91
91
### Run in Current Terminal
92
92
**task-execution/current-terminal**
93
93
94
-
Sends the task command to the currently active terminal. Triggered by the circle-play button or `tasktree.runInCurrentTerminal` command.
94
+
Sends the task command to the currently active terminal. Triggered by the circle-play button or `commandtree.runInCurrentTerminal` command.
95
95
96
96
### Debug
97
97
**task-execution/debug**
98
98
99
-
Launches the task using the VS Code debugger. Only applicable to launch configurations. Triggered by the bug button or `tasktree.debug` command.
99
+
Launches the task using the VS Code debugger. Only applicable to launch configurations. Triggered by the bug button or `commandtree.debug` command.
100
100
101
101
## Quick Tasks
102
102
**quick-tasks**
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/tasktree.json`:
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`:
105
105
106
106
```json
107
107
{
@@ -120,7 +120,7 @@ Tags group related tasks for organization and filtering.
120
120
### Tag Configuration File
121
121
**tagging/config-file**
122
122
123
-
Tags are defined in `.vscode/tasktree.json` under the `tags` key:
123
+
Tags are defined in `.vscode/commandtree.json` under the `tags` key:
124
124
125
125
```json
126
126
{
@@ -154,25 +154,25 @@ This file can be committed to version control to share task organization with a
154
154
155
155
-**Add tag to task**: Right-click a task > "Add Tag" > select existing or create new
156
156
-**Remove tag from task**: Right-click a task > "Remove Tag"
Free-text filter via toolbar or `tasktree.filter` command. Matches against task names.
165
+
Free-text filter via toolbar or `commandtree.filter` command. Matches against task names.
166
166
167
167
### Tag Filter
168
168
**filtering/tag**
169
169
170
-
Pick a tag from the toolbar picker (`tasktree.filterByTag`) to show only tasks matching that tag's patterns.
170
+
Pick a tag from the toolbar picker (`commandtree.filterByTag`) to show only tasks matching that tag's patterns.
171
171
172
172
### Clear Filter
173
173
**filtering/clear**
174
174
175
-
Remove all active filters via toolbar button or `tasktree.clearFilter` command.
175
+
Remove all active filters via toolbar button or `commandtree.clearFilter` command.
176
176
177
177
## Parameterized Tasks
178
178
**parameterized-tasks**
@@ -197,12 +197,12 @@ All settings are configured via VS Code settings (`Cmd+,` / `Ctrl+,`).
197
197
### Exclude Patterns
198
198
**settings/exclude-patterns**
199
199
200
-
`tasktree.excludePatterns` - Glob patterns to exclude from task discovery. Default includes `**/node_modules/**`, `**/.vscode-test/**`, and others.
200
+
`commandtree.excludePatterns` - Glob patterns to exclude from task discovery. Default includes `**/node_modules/**`, `**/.vscode-test/**`, and others.
201
201
202
202
### Sort Order
203
203
**settings/sort-order**
204
204
205
-
`tasktree.sortOrder` - How tasks are sorted within categories:
205
+
`commandtree.sortOrder` - How tasks are sorted within categories:
206
206
207
207
| Value | Description |
208
208
|-------|-------------|
@@ -213,12 +213,12 @@ All settings are configured via VS Code settings (`Cmd+,` / `Ctrl+,`).
213
213
### Show Empty Categories
214
214
**settings/show-empty-categories**
215
215
216
-
`tasktree.showEmptyCategories` - Whether to display category nodes that contain no discovered tasks.
216
+
`commandtree.showEmptyCategories` - Whether to display category nodes that contain no discovered tasks.
217
217
218
218
## User Data Storage
219
219
**user-data-storage**
220
220
221
-
TaskTree stores workspace-specific data in `.vscode/tasktree.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 task pins and tag definitions.
222
222
223
223
---
224
224
@@ -230,7 +230,7 @@ TaskTree stores workspace-specific data in `.vscode/tasktree.json`. This file is
230
230
### Overview
231
231
**semantic-search/overview**
232
232
233
-
TaskTree will use an LLM to generate a plain-language summary of what each discovered script does. These summaries, along with vector embeddings of the script content and summary, are stored in a local database. This enables **semantic search**: users can describe what they want in natural language and find the right script without knowing its exact name or path.
233
+
CommandTree will use an LLM to generate a plain-language summary of what each discovered script does. These summaries, along with vector embeddings of the script content and summary, are stored in a local database. This enables **semantic search**: users can describe what they want in natural language and find the right script without knowing its exact name or path.
234
234
235
235
### LLM Integration
236
236
**semantic-search/llm-integration**
@@ -239,9 +239,9 @@ The preferred integration path is **GitHub Copilot** via the VS Code Language Mo
239
239
240
240
**Opt-in flow:**
241
241
242
-
1. On first workspace load (or when the user enables the feature), TaskTree shows a simple prompt:
242
+
1. On first workspace load (or when the user enables the feature), CommandTree shows a simple prompt:
243
243
> *"Would you like to use GitHub Copilot to summarise scripts in your workspace?"*
244
-
2. If the user accepts, TaskTree uses `vscode.lm.selectChatModels({ vendor: 'copilot' })` to access a lightweight model (e.g. `gpt-4o-mini`) for summarisation. The VS Code API handles Copilot authentication and consent automatically.
244
+
2. If the user accepts, CommandTree uses `vscode.lm.selectChatModels({ vendor: 'copilot' })` to access a lightweight model (e.g. `gpt-4o-mini`) for summarisation. The VS Code API handles Copilot authentication and consent automatically.
245
245
3. If the user declines, the feature remains **dormant**. No summaries are generated, and the extension behaves as before. The user can enable it later via settings.
246
246
247
247
**Alternative providers:**
@@ -256,9 +256,9 @@ 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/tasktree.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 task 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
-
The migration is automatic and transparent. The `.vscode/tasktree.json` file is read once during migration, and the database becomes the single source of truth going forward.
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
263
263
### Data Structure
264
264
**semantic-search/data-structure**
@@ -290,7 +290,7 @@ erDiagram
290
290
### Search UX
291
291
**semantic-search/search-ux**
292
292
293
-
The existing filter bar (`tasktree.filter`) gains a semantic search mode:
293
+
The existing filter bar (`commandtree.filter`) gains a semantic search mode:
294
294
295
295
1. User types a natural-language query (e.g. *"deploy to staging"*, *"run database migrations"*, *"lint and format code"*).
296
296
2. The query is embedded using the same model that produced the stored embeddings.
0 commit comments