patchxnote-agent 0.2.8 → 0.2.10
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 +19 -2
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -9,9 +9,17 @@ PatchXNote Agent is the local AI assistant connector for PatchXNote. It lets an
|
|
|
9
9
|
Give this one-line prompt to a local-command-capable AI assistant:
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
|
|
12
|
+
Help me connect PatchXNote MCP and install the PatchXNote MCP Skill when the client supports Agent Skills. First, if this is a local command-capable environment where the skills CLI can run, execute npx -y skills add ZsTs119/patchxnote-agent --skill patchxnote-mcp -g on this machine so future or long sessions remember the PatchXNote SOP; if skill installation is not supported, continue with MCP setup directly. Identify the MCP client you are running in; if this is a local MCP client such as Codex, Cursor, VS Code, Claude Desktop, Claude Code, or Windsurf, run npx -y patchxnote-agent@latest setup --client <client-id> on this machine in the same OS/runtime that will later launch the MCP server. If you are not sure which client ID to use, first run npx -y patchxnote-agent@latest mcp config and use the printed generic stdio config. For login, open the browser and let me complete PatchXNote phone-code authorization there; do not ask me to paste OTP codes, OAuth codes, authorization codes, access tokens, refresh tokens, or webhook secrets into chat. After setup, call patchxnote_get_current_user and patchxnote_list_memories with {"platform":"mobile","limit":5} to verify it works. References: https://github.com/ZsTs119/patchxnote-agent and https://patchx2025.feishu.cn/wiki/PnVRwYT7IirFPckairGcWPnHnCd
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
+
The repository includes an Agent Skills package at `skills/patchxnote-mcp/`. After the repository version containing it is available on GitHub, compatible agents can install it with:
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
npx -y skills add ZsTs119/patchxnote-agent --skill patchxnote-mcp -g
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The skill teaches the AI the PatchXNote SOP. MCP setup and browser login still use the commands below.
|
|
22
|
+
|
|
15
23
|
Run setup for a supported local client:
|
|
16
24
|
|
|
17
25
|
```sh
|
|
@@ -20,6 +28,15 @@ npx -y patchxnote-agent@latest setup --client vscode
|
|
|
20
28
|
npx -y patchxnote-agent@latest setup --client codex
|
|
21
29
|
```
|
|
22
30
|
|
|
31
|
+
PatchXNote Agent currently exposes two login surfaces and two MCP service shapes:
|
|
32
|
+
|
|
33
|
+
| Mode | Entry | Use when |
|
|
34
|
+
| --- | --- | --- |
|
|
35
|
+
| Browser MCP login | `npx -y patchxnote-agent@latest mcp login` | Recommended for desktop editors and local MCP hosts. |
|
|
36
|
+
| Terminal CLI login | `npx -y patchxnote-agent@latest login` | Terminal-only users, headless runtimes, or the legacy local Agent path. |
|
|
37
|
+
| Local MCP service | `npx -y patchxnote-agent@latest mcp serve` | VS Code, Cursor, Codex, Claude Desktop, Windsurf, Trae, Qoder, WorkBuddy, and other stdio MCP clients. |
|
|
38
|
+
| Hosted remote MCP gateway | `https://ws-lab.patch-x.cn/patchnote-test-api/mcp` | Feishu Aily, Doubao Work Partner, Tencent Agent Development Platform, enterprise WorkBuddy, and other platform clients that cannot run local commands. |
|
|
39
|
+
|
|
23
40
|
Log in with browser OAuth, then check or clear the MCP login state:
|
|
24
41
|
|
|
25
42
|
```sh
|
|
@@ -46,7 +63,7 @@ The older terminal Agent login remains available for legacy local CLI/MCP fallba
|
|
|
46
63
|
npx -y patchxnote-agent@latest login
|
|
47
64
|
```
|
|
48
65
|
|
|
49
|
-
`setup` reuses the same `mcp login` browser OAuth flow. The GoServer website owns phone OTP input; the local Agent owns the loopback callback, token exchange, secure storage, and stdio bridge. `mcp serve` never opens a browser during editor startup. It stores credentials in the OS-native keychain and keeps MCP config free of phone numbers, OTP codes, access tokens, and
|
|
66
|
+
`setup` reuses the same `mcp login` browser OAuth flow. The GoServer website owns phone OTP input; the local Agent owns the loopback callback, token exchange, secure storage, and stdio bridge. `mcp serve` never opens a browser during editor startup. It stores credentials in the OS-native keychain and keeps MCP config free of phone numbers, OTP codes, access tokens, refresh tokens, webhook secrets, and base URL by default.
|
|
50
67
|
|
|
51
68
|
P0 local client IDs: `vscode`, `cursor`, `codex`, `claude-code`, `claude-desktop`, `windsurf`, `trae`, `qoder`, `workbuddy`.
|
|
52
69
|
|
package/package.json
CHANGED