[promptless]

Open in Promptless

Proposed changes

Adds Cursor desktop sessions as a native trace source for Promptless Instruction Governance (PIG). The pages state the analyzer version Cursor needs, what the Cursor collector covers, and what has not been qualified yet. Readers can then enable Cursor collection on a pilot host and confirm it works before they roll it out more widely.

This PR now carries only the Cursor-specific changes on top of main, after the #1039 installation-guide merge (bc36138). Installation, enrollment, acceptance SQL, and dashboard checks come from #1039 unchanged. Verify your deployment already lists cursor as a source on main.

• Enroll your hosts: Cursor is now one of the supported host families. Prerequisites: Node.js for the Cursor launcher, and analyzer 0.3.3 or later. Step 1 tells readers to check that the Workers settings page shows Cursor ingestion supported, and states that the default enrollment policy adds Cursor when the analyzer reports support. A new Cursor collection section covers:

  • the four generated hooks (sessionStart, stop, sessionEnd, subagentStop) and their 250 ms timeout
  • read-only, WAL-only database access
  • scope: desktop Agent sessions and subagents; not the Cursor CLI, Cloud Agents, Tab completions, or binary images
  • fail-open behavior when the analyzer or enrollment fails
  • Node.js and Python on Cursor's PATH, and the cursor-launcher-status.json diagnostic
  • manual --host cursor commands with CURSOR_PLUGIN_ROOT, including Windows py -3
  • qualification status

  A troubleshooting row covers Cursor hosts that are enrolled but send no traces.

• Trace object and sources: adds the cursor source row with its transcript glob, and per-OS state.vscdb paths with the PROMPTLESS_CURSOR_DATABASE override and the Windows APPDATA fallback. Also covers what the Cursor collector exports, its journal location and collection limits (including the 4,096 pending-notification limit), and that Cursor uses its own generated hooks.

• Supported agents, FAQ, How it works, Key concepts: list Cursor desktop sessions as a native trace source with analyzer 0.3.3 or later, and include Cursor in the pig plugin targets that carry the host runtime.

• Changelog: one October 2026 entry, "Collect Cursor sessions as native traces". The first stable analyzer with Cursor support, 0.3.3, was published on 2026-10-07. The September --device entry that the merge brought back is removed again, because docs: Complete the PIG 0.3.6 installation path, from release verification to a verified first session #1039 removed it as unshipped.

Source and release evidence

• Stable catalog: Promptless/pig-deploy catalog/stable.json lists 0.3.1, 0.3.3, 0.3.4, 0.3.5, and 0.3.6. 0.3.6 (manifest sha256 a4eafe78…, source db79db5) ships analyzer image sha256:0379f9d7…. Promptless/promptless ops/pig/candidate.json records that image as built from analyzer source 625624a7.
• Analyzer capability: 625624a7 and the 0.3.3/0.3.4 analyzer source 59a33727 both include the Cursor ingestion merge from #5170 (5488e1f). Both report every AgentHost value, including cursor, in the check-in's supported_trace_sources (pig_trace_analyzer/sync/service.py). The 0.3.1 analyzer (21e72b8) predates #5170. The 0.3.5 image was built on 2026-10-09 from source after #5450, which also follows #5170. That is inferred from the build date and was not checked line by line.
• Hosted policy and dashboard: on Promptless/promptless main, runtime/pig/policy.py adds Cursor to the default policy only when the latest worker report includes cursor. runtime/pig/routes.py and WorkerStateCard.tsx show Cursor ingestion supported on the Workers settings page.
• Toolchain: hubs install pig-toolchain from @main (4c02abf). managed_runtime.py adds the runtime to claude, codex, and cursor and writes the four Cursor hooks. The other details above come from docs/cursor-trace-ingestion.md and the runtime sources: database paths and override, transcript glob, Python lookup, WAL check, journal limits, and scope exclusions.

Qualification status (not claimed as tested)

The source and release support above comes from code, not from a capture test. The toolchain checked the adapter's data format against Cursor desktop 3.19.19, and synthetic tests cover the collector and analyzer contracts. Desktop dogfooding on macOS, Linux, and Windows is still listed as a release requirement. The 0.3.6 owner sign-off also lists live canonical trace analysis as unverified. The docs say end-to-end capture is not yet qualified, and tell readers to pilot one host per OS.

Coordination

Merge #1047 first, then #1125. The #1125 branch contains this PR’s final head (525383f) and resolves the shared-page overlap.

Checklist

• Instructions and examples match the current product behavior.
• Links and image references are valid.
• Changed pages render correctly.

Validation: npm run check (typecheck, MCP and search tests, full build, search build checks) passed. npm run test:smoke passed (28/28). npm run lint:md and docmeta validate passed (131/131). Vale reported no findings on the changed files, for both the collection rules and the canonical and Knowledge Base rules. Every new internal link and anchor resolves in the build output, and the Workers settings URL returns 200.

Review requests addressed in this pass

The PR had no human review comments; prior threads were Promptless citation comments, which this pass replaced at the final line anchors. Adit Chandra's refresh request was applied as follows: merged origin/main at bc36138 (no rebase or force-push); kept #1039's installation, enrollment, acceptance SQL, and dashboard checks unchanged; replaced the "no published analyzer includes Cursor support" hold with the verified requirement (analyzer 0.3.3 or later, current stable 0.3.6); removed the --device changelog entry the merge had brought back; and moved the Cursor changelog entry to October 2026 to match when a stable analyzer with Cursor support was published.

Trigger Events

• Promptless/promptless #5170: Ingest Cursor trace revisions after analyzer capability checks
• Promptless/promptless #5172: Enable Cursor in default enrollment policies for capable analyzers
• Promptless MCP by Adit Chandra

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
promptless-docs	Ready	Preview	Oct 16, 2026 8:44pm UTC