@qzoft/check-list 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -38
- package/package.json +8 -3
package/README.md
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
# check-list
|
|
1
|
+
# @qzoft/check-list
|
|
2
2
|
|
|
3
3
|
A general-purpose MCP App that discovers and displays checklists from **all markdown files** in your project, rendered as an interactive checkbox UI inside VS Code Copilot Chat. Changes are saved automatically — no confirmation needed.
|
|
4
4
|
|
|
5
|
+
Available on npm: [`@qzoft/check-list`](https://www.npmjs.com/package/@qzoft/check-list)
|
|
6
|
+
|
|
5
7
|
## Prerequisites
|
|
6
8
|
|
|
7
9
|
- Node.js 18+
|
|
@@ -9,25 +11,22 @@ A general-purpose MCP App that discovers and displays checklists from **all mark
|
|
|
9
11
|
|
|
10
12
|
## Setup
|
|
11
13
|
|
|
12
|
-
|
|
13
|
-
```sh
|
|
14
|
-
git clone https://github.com/qzoft/check-list.git
|
|
15
|
-
cd check-list
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
2. Install dependencies:
|
|
19
|
-
```sh
|
|
20
|
-
npm install
|
|
21
|
-
```
|
|
14
|
+
Add the following to your project's `.vscode/mcp.json`:
|
|
22
15
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
16
|
+
```json
|
|
17
|
+
{
|
|
18
|
+
"servers": {
|
|
19
|
+
"check-list": {
|
|
20
|
+
"command": "npx",
|
|
21
|
+
"args": ["-y", "@qzoft/check-list"]
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
```
|
|
27
26
|
|
|
28
|
-
|
|
27
|
+
That's it — VS Code will download and run the server automatically. No cloning or building required.
|
|
29
28
|
|
|
30
|
-
|
|
29
|
+
In Copilot Chat, ask **"show my tasks"** → the `list_tasks` tool scans the project and renders the interactive checkbox UI.
|
|
31
30
|
|
|
32
31
|
## Usage
|
|
33
32
|
|
|
@@ -69,26 +68,9 @@ Once the server is running, you can use two tools in Copilot Chat:
|
|
|
69
68
|
| Variable | Description | Example |
|
|
70
69
|
|---------------|-----------------------------------------------------|----------------------------------|
|
|
71
70
|
| `PROJECT_DIR` | Root directory to scan for markdown files | `~/repos/my-project` |
|
|
72
|
-
| `TASK_FILE` | *(backward-compat)* Falls back to parent directory | `~/repos/my-project/task.md` |
|
|
73
71
|
|
|
74
72
|
If neither is set, the server uses the current working directory.
|
|
75
73
|
|
|
76
|
-
The project directory is configured in `.vscode/mcp.json`:
|
|
77
|
-
|
|
78
|
-
```json
|
|
79
|
-
{
|
|
80
|
-
"servers": {
|
|
81
|
-
"check-list": {
|
|
82
|
-
"command": "node",
|
|
83
|
-
"args": ["dist/server.js"],
|
|
84
|
-
"env": {
|
|
85
|
-
"PROJECT_DIR": "${workspaceFolder}"
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
```
|
|
91
|
-
|
|
92
74
|
## Task file format
|
|
93
75
|
|
|
94
76
|
The parser recognizes `## Section` headers and checkbox list items in any `.md` file:
|
|
@@ -99,7 +81,7 @@ The parser recognizes `## Section` headers and checkbox list items in any `.md`
|
|
|
99
81
|
- [ ] Update README
|
|
100
82
|
|
|
101
83
|
## This Week
|
|
102
|
-
- [
|
|
84
|
+
- [x] Review PRs
|
|
103
85
|
- [ ] Deploy to staging
|
|
104
86
|
```
|
|
105
87
|
|
|
@@ -110,12 +92,10 @@ The server skips common non-project directories (`node_modules`, `.git`, `dist`,
|
|
|
110
92
|
## Project structure
|
|
111
93
|
|
|
112
94
|
```
|
|
113
|
-
check-list
|
|
95
|
+
@qzoft/check-list
|
|
114
96
|
├── package.json
|
|
115
97
|
├── tsconfig.json
|
|
116
98
|
├── README.md
|
|
117
|
-
├── .vscode/
|
|
118
|
-
│ └── mcp.json # VS Code MCP server config
|
|
119
99
|
├── src/
|
|
120
100
|
│ ├── server.ts # MCP server entry point
|
|
121
101
|
│ ├── parser.ts # Markdown checkbox parser
|
package/package.json
CHANGED
|
@@ -1,11 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qzoft/check-list",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "MCP App for interactive task management from markdown files",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/server.js",
|
|
7
|
-
"bin":
|
|
8
|
-
|
|
7
|
+
"bin": {
|
|
8
|
+
"check-list": "dist/server.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"dist",
|
|
12
|
+
"ui"
|
|
13
|
+
],
|
|
9
14
|
"scripts": {
|
|
10
15
|
"build": "tsc",
|
|
11
16
|
"start": "node dist/server.js",
|