@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.
Files changed (2) hide show
  1. package/README.md +18 -38
  2. 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
- 1. Clone this repo:
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
- 3. Build the project:
24
- ```sh
25
- npm run build
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
- 4. Open VS Code the `.vscode/mcp.json` config auto-registers the server. VS Code will pick it up automatically when you open the workspace.
27
+ That's it VS Code will download and run the server automatically. No cloning or building required.
29
28
 
30
- 5. In Copilot Chat, ask **"show my tasks"** → the `list_tasks` tool scans the project and renders the interactive checkbox UI.
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
- - [ ] Review PRs
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.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": "dist/server.js",
8
- "files": ["dist", "ui"],
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",