Conflu — Thingworx Source Management (VS Code / Cursor extension)

Thin UI layer over the conflu CLI. Provides file-level compare between projects/ (local source) and live ThingWorx, via native Monaco vscode.diff.

Install the CLI first:

npm i -g @xudesheng/conflu

MVP commands

• Conflu: Compare with environment… — right-click any file under projects/<unit>/<EntityTypePlural>/<Name>/... → pick env → the extension spawns conflu cache fetch -e <env> <EntityTypePlural>/<Name> --format json to pull that entity into .conflu/cache/<env>/, then opens vscode.diff(local, cache).
• Conflu: Open cache folder for environment… — add .conflu/cache/<env>/ as a workspace folder for browsing the most recently fetched entities.

Conflu: Refresh cache for environment… is not contributed at MVP — the CLI conflu cache refresh currently exits 2 with a "not implemented" message, and the extension deliberately does not expose a command that would only surface that error. The refresh command will return once the full local-driven refresh body lands.

See the main conflu repository for the full contract (docs/core/compare.md and docs/core/vscode-extension.md).

Development

cd vscode-extension
npm install
npm run build      # esbuild → dist/extension.js
npm run package    # vsce package → conflu-<version>.vsix

The documented npm run package command must succeed without extra manual vsce flags — if it does not, that is a packaging bug to fix.

Needs conflu on PATH when the extension runs. The recommended install path is:

npm i -g @xudesheng/conflu

Compatibility

• VS Code 1.85+
• Cursor (VS Code fork, same Extension API)

Version coupling

The extension's package.json#version tracks the conflu CLI's workspace Cargo.toml version (same release tag). package.json#conflu.minCliSchemaVersion declares the minimum --format json schema version this build understands.