lensmcp 1.19.0 → 1.20.1

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 (17) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/README.md +39 -26
  3. package/bundled/capture-runner.js +9 -9
  4. package/bundled/dashboard.js +50 -50
  5. package/bundled/main.js +37 -37
  6. package/lib/cli.js +14 -14
  7. package/package.json +2 -1
  8. package/plugin/.claude-plugin/plugin.json +1 -1
  9. package/plugins/lensmcp/.codex-plugin/plugin.json +41 -0
  10. package/plugins/lensmcp/.mcp.json +9 -0
  11. package/plugins/lensmcp/README.md +38 -0
  12. package/plugins/lensmcp/skills/lensmcp-dashboard/SKILL.md +16 -0
  13. package/plugins/lensmcp/skills/lensmcp-start/SKILL.md +20 -0
  14. package/plugins/lensmcp/skills/lensmcp-status/SKILL.md +27 -0
  15. package/plugins/lensmcp/skills/lensmcp-stop/SKILL.md +16 -0
  16. package/plugins/lensmcp/skills/using-lensmcp/SKILL.md +42 -0
  17. package/bundled/cluster-app.css +0 -1
package/.agents/plugins/marketplace.json ADDED
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "lensmcp-marketplace",
3
+ "interface": {
4
+ "displayName": "LensMCP Marketplace"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "lensmcp",
9
+ "source": {
10
+ "source": "local",
11
+ "path": "./plugins/lensmcp"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Developer Tools"
18
+ }
19
+ ]
20
+ }
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > The observability lens for coding agents — run the MCP server your agent connects to and watch your apps live.
4
4
 
5
- **LensMCP** gives coding agents (and you) eyes on running applications. It captures traces, flows, and logs from your app and exposes them through an [MCP](https://modelcontextprotocol.io) server, so an agent can ask *"what just happened?"* and get a real answer — request flows, state changes, errors, and browser activity — instead of guessing from source code alone.
5
+ **LensMCP** gives coding agents (and you) eyes on running applications. It captures traces, flows, and logs from your app and exposes them through an [MCP](https://modelcontextprotocol.io) server, so an agent can ask _"what just happened?"_ and get a real answer — request flows, state changes, errors, and browser activity — instead of guessing from source code alone.
6
6
 
7
7
  `lensmcp` is the CLI. It runs the LensMCP MCP server (over stdio or HTTP) that agents discover and connect to, and it serves a local **dashboard** where you can browse Flows, Cluster, Logs, and Resources captured from your running apps. It also ships helpers to wire LensMCP into your workspace (`install`) and to diagnose your setup (`doctor`).
8
8
 
@@ -20,15 +20,15 @@ Requires **Node 18+** (Node 20+ recommended; this workspace pins Node 26 via `.n
20
20
  lensmcp <command> [options]
21
21
  ```
22
22
 
23
- | Command | Description |
24
- | --- | --- |
25
- | `lensmcp mcp` | Launch the LensMCP MCP server that agents connect to. Defaults to **stdio**; set `--transport http` (or `LENSMCP_TRANSPORT=http`) to serve over HTTP on `--port` (default **3000**). |
26
- | `lensmcp dashboard` | Serve the live web view of the lens — Flows, Cluster, Logs, Resources — on `--port` (default **4321**). |
27
- | `lensmcp install` | Install LensMCP into the host Nx workspace (delegates to `nx g @lensmcp/nx-plugin:init`). Wires `.mcp.json` so agents auto-discover the server, plus `.gitignore` and config. Idempotent. |
28
- | `lensmcp doctor` | Diagnose the install: Node version, workspace + plugin registration, `.mcp.json` entry, MCP bundle, per-project Vite/Nest wiring, `agent-dev` targets, and Chrome for browser capture. |
29
- | `lensmcp rollout` | Edit the gateway rollout config (`@lensmcp/cluster`) — `add-cohort`, `set-weight`, `promote`, `abort`, `add-rule`, `remove-rule`, `status`. |
30
- | `lensmcp --version` | Print the installed `lensmcp` version. |
31
- | `lensmcp --help` | Show usage. |
23
+ | Command | Description |
24
+ | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
25
+ | `lensmcp mcp` | Launch the LensMCP MCP server that agents connect to. Defaults to **stdio**; set `--transport http` (or `LENSMCP_TRANSPORT=http`) to serve over HTTP on `--port` (default **3000**). |
26
+ | `lensmcp dashboard` | Serve the live web view of the lens — Flows, Cluster, Logs, Resources — on `--port` (default **4321**). |
27
+ | `lensmcp install` | Install LensMCP into the host Nx workspace (delegates to `nx g @lensmcp/nx-plugin:init`). Wires `.mcp.json` so agents auto-discover the server, plus `.gitignore` and config. Idempotent. |
28
+ | `lensmcp doctor` | Diagnose the install: Node version, workspace + plugin registration, `.mcp.json` entry, MCP bundle, per-project Vite/Nest wiring, `agent-dev` targets, and Chrome for browser capture. |
29
+ | `lensmcp rollout` | Edit the gateway rollout config (`@lensmcp/cluster`) — `add-cohort`, `set-weight`, `promote`, `abort`, `add-rule`, `remove-rule`, `status`. |
30
+ | `lensmcp --version` | Print the installed `lensmcp` version. |
31
+ | `lensmcp --help` | Show usage. |
32
32
 
33
33
  ### `lensmcp mcp`
34
34
 
@@ -36,11 +36,11 @@ lensmcp <command> [options]
36
36
  lensmcp mcp [--cwd <dir>] [--transport stdio|http] [--port <n>]
37
37
  ```
38
38
 
39
- | Flag | Default | Description |
40
- | --- | --- | --- |
41
- | `--cwd <dir>` | current directory | Workspace root the server runs against. |
42
- | `--transport <stdio\|http>` | `stdio` | Transport agents connect over. `stdio` for local agents (Claude Code, Cursor); `http` to expose an HTTP endpoint. |
43
- | `--port <n>` | `3000` | HTTP port (used when transport is `http`). |
39
+ | Flag | Default | Description |
40
+ | --------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------- |
41
+ | `--cwd <dir>` | current directory | Workspace root the server runs against. |
42
+ | `--transport <stdio\|http>` | `stdio` | Transport agents connect over. `stdio` for local agents (Claude Code, Cursor); `http` to expose an HTTP endpoint. |
43
+ | `--port <n>` | `3000` | HTTP port (used when transport is `http`). |
44
44
 
45
45
  Reads/writes the cross-process event file at `<cwd>/.lensmcp/events.jsonl` (override with `LENSMCP_EVENT_FILE`) — the same file your instrumented apps write to, so ingest and producers rendezvous with zero extra config.
46
46
 
@@ -50,10 +50,10 @@ Reads/writes the cross-process event file at `<cwd>/.lensmcp/events.jsonl` (over
50
50
  lensmcp dashboard [--cwd <dir>] [--port <n>]
51
51
  ```
52
52
 
53
- | Flag | Default | Description |
54
- | --- | --- | --- |
55
- | `--cwd <dir>` | current directory | Workspace root to read events from. |
56
- | `--port <n>` | `4321` | Port to serve the dashboard on (`http://localhost:<port>`). |
53
+ | Flag | Default | Description |
54
+ | ------------- | ----------------- | ----------------------------------------------------------- |
55
+ | `--cwd <dir>` | current directory | Workspace root to read events from. |
56
+ | `--port <n>` | `4321` | Port to serve the dashboard on (`http://localhost:<port>`). |
57
57
 
58
58
  Tails the same `.lensmcp/events.jsonl` the MCP server uses, so the dashboard shows the identical live flows, signals, and resources your agent sees.
59
59
 
@@ -83,13 +83,13 @@ Edits a gateway rollout config with validated, atomic writes that the production
83
83
 
84
84
  ## Environment variables
85
85
 
86
- | Variable | Used by | Default |
87
- | --- | --- | --- |
88
- | `LENSMCP_TRANSPORT` | `mcp` | `stdio` (overridden by `--transport`) |
89
- | `LENSMCP_PORT` | `mcp` | `3000` (overridden by `--port`) |
90
- | `LENSMCP_DASHBOARD_PORT` | `dashboard` | `4321` (overridden by `--port`) |
91
- | `LENSMCP_EVENT_FILE` | `mcp`, `dashboard` | `<cwd>/.lensmcp/events.jsonl` |
92
- | `CHROME_PATH` | `doctor` | auto-detected (browser capture only) |
86
+ | Variable | Used by | Default |
87
+ | ------------------------ | ------------------ | ------------------------------------- |
88
+ | `LENSMCP_TRANSPORT` | `mcp` | `stdio` (overridden by `--transport`) |
89
+ | `LENSMCP_PORT` | `mcp` | `3000` (overridden by `--port`) |
90
+ | `LENSMCP_DASHBOARD_PORT` | `dashboard` | `4321` (overridden by `--port`) |
91
+ | `LENSMCP_EVENT_FILE` | `mcp`, `dashboard` | `<cwd>/.lensmcp/events.jsonl` |
92
+ | `CHROME_PATH` | `doctor` | auto-detected (browser capture only) |
93
93
 
94
94
  ## Quick start
95
95
 
@@ -113,6 +113,19 @@ lensmcp mcp --transport http --port 3000 # or expose over HTTP
113
113
 
114
114
  Most local agents (Claude Code, Cursor, VS Code) read `.mcp.json` and launch `lensmcp mcp` over stdio automatically after `lensmcp install` — no manual wiring needed.
115
115
 
116
+ ### Codex plugin
117
+
118
+ The npm package also ships a native Codex plugin with LensMCP skills and a project-local MCP
119
+ server. After installing and setting up LensMCP, add the package as a Codex marketplace:
120
+
121
+ ```bash
122
+ codex plugin marketplace add ./node_modules/lensmcp
123
+ codex plugin add lensmcp@lensmcp-marketplace
124
+ ```
125
+
126
+ Start a new Codex thread after installation. The existing Claude Code plugin remains available
127
+ separately and is unchanged.
128
+
116
129
  ## How it fits
117
130
 
118
131
  `lensmcp` is the entry point of the LensMCP toolchain. [`@lensmcp/nx-plugin`](https://github.com/kiwiapps-ltd/lensmcp) wires LensMCP into your workspace and projects; the instrumentation libraries (`@lensmcp/vite-plugin`, `@lensmcp/nest-instrumentation`, `@lensmcp/react-instrumentation`, and friends) capture flows, state, and logs from running apps into `.lensmcp/events.jsonl`; and [`@lensmcp/cluster`](https://github.com/kiwiapps-ltd/lensmcp) powers the gateway and targeted rollouts driven by `lensmcp rollout`.