LWC v0.14.6
LWC v0.14.6 makes Agent integration a first-class, host-aware capability. It introduces one LWC MCP surface for durable memory and CodeGraph exploration, adds strong installation adapters for 12 Agent targets, and keeps every managed integration idempotent and precisely removable.
Highlights
Unified LWC MCP
- Adds the standard stdio entry point
lwc serve --mcp. - Exposes bounded, read-only LWC memory exploration through one MCP server.
- Routes code-graph requests through LWC to the project-scoped CodeGraph child process, so users configure
lwc, not a separatecodegraphMCP server. - Enforces workspace boundaries, request and output limits, timeouts, protocol recovery, and side-effect-free missing-index behavior.
Host-aware Agent installation
lwc agent install now uses a common AgentTarget contract with hand-written adapters for:
- Claude Code
- Codex
- Cursor
- OpenCode
- Hermes
- Gemini CLI
- Antigravity
- Kiro
- GitHub Copilot for VS Code
- GitHub Copilot CLI
- GitHub Copilot for JetBrains
- Pi
Each adapter installs the official surfaces supported by its host: MCP configuration, Skills, lifecycle Hooks, global or project Instructions, plugins/extensions, and permissions where applicable. Capability gaps remain explicit when a host does not provide a corresponding official mechanism.
Installation supports automatic detection, global or project scope, non-interactive defaults with --yes, pure configuration preview with --print-config, idempotent refresh, migration from LWC-owned legacy entries, and exact uninstall without overwriting user edits.
lwc agent install
lwc agent install --yes
lwc agent install --print-config codex
lwc agent statusProactive memory guidance
- Ships complete
using-lwcSkills covering core memory, document and code graphs, word graph, strong-context tags, document conversion, activation timing, Agent onboarding, and recovery. - Hooks can provide bounded strong context and readiness guidance at native lifecycle events.
- First-use guidance detects missing Wiki, graph, converter, and Agent integration readiness without silently enabling optional capabilities.
- Routine project commands use the current directory directly;
LWC_PROJECT_ROOTis reserved for intentionally targeting another project boundary.
CodeGraph integration
- Reuses one pinned CodeGraph runtime from the global cache while keeping indexes project-local.
- Fuses LWC-owned CodeGraph MCP and instruction surfaces into the LWC integration.
- Preserves native Windows paths and guards workspace/index boundaries.
Reliability fixes
- Sparse Changeset lint now evaluates the live Wiki plus the staged delta transactionally, eliminating false dangling-link and search-index failures for tag-only changes without mutating live state.
- Changeset conflict and inverse-patch fingerprints now treat provenance as an order-independent set, preventing unchanged multi-provenance pages from being rejected during commit.
- Work commands now honor
--changeset, so graph Work returned by a draft can be listed, inspected, watched, cancelled, and resumed through the same draft selector. - Drafts inherit project-local graph and converter configuration while keeping Work queues and graph sidecars isolated per Changeset; parallel drafts can no longer observe or overwrite each other's derived state.
- First-time graph projection now builds the complete draft baseline before applying document increments, so live Sources remain present in draft verification.
- Changeset rollback now queues and returns observable graph Work, including retry-safe recovery after Markdown materialization failures, and leaves
graph verifyclean. - Tracked source paths now merge as live revisions, remap concurrent source-ID allocations across unrelated live writes, preserve page citations, and restore the previous path head and graph projection exactly on rollback.
- Commit and rollback recovery persist their graph document sets, so retrying after a Work-queue failure requeues the missing projection; legacy commit records safely fall back to a full projection.
- Sparse inverse patches remain checksum-compatible with earlier 0.14.x payloads while adding exact page, source-path, and inbound-link rollback guards.
- Sparse rollback preserves pre-existing dangling Wiki links, detects only genuine inbound-link conflicts, and no longer depends on page restoration order.
- Draft runtime paths reject symlink substitution before canonical mutations, safely recreate runtime directories for pre-0.14.5 drafts, and clean up exactly on commit or discard.
- The Viewer keeps scripts and style elements CSP-restricted, permits only the fixed style hashes/attributes required by the bundled 3D renderer, and strips
styleattributes from rendered Wiki Markdown. - Tag-only Changesets stage only a lightweight page reference and Tag membership instead of copying page bodies, links, sources, provenance, and search rows.
- Refresh now tracks accessory files introduced after an older manifest was created, so future refresh and uninstall remain complete.
- Agent installation preserves foreign content, detects ownership conflicts before writes, and keeps uninstall snapshots across upgrades.
- Linux and macOS integration tests now validate their platform-specific VS Code MCP locations.
- The sparse tag-only regression closes its inspection connection before commit, allowing the same release test to pass under Windows file-lock semantics.
Compatibility and upgrade notes
- No intentional breaking CLI or Wiki schema changes.
- Existing Wiki data and project-local CodeGraph indexes remain compatible.
- Agent integrations created by older LWC versions can be upgraded with
lwc agent refreshor an idempotentlwc agent install. - Official binary archives are published for x86_64 and arm64 macOS, glibc Linux, and Windows.
- MarkItDown, AnyDoc, document graph, and CodeGraph remain optional and are not enabled without configuration or initialization.
Install
curl --proto '=https' --tlsv1.2 -fsSL \
https://github.com/JanYork/llm-wiki-cli/releases/latest/download/install.sh | shAfter the npm package is published:
npm install --global @i-xor/lwc@0.14.6All native archives are covered by the published SHA256SUMS; the shell and npm installers verify the selected archive before installation.
Verification
The release gates cover formatting, Clippy, the full Rust test suite, Viewer tests/type checking/build reproducibility, npm packaging, installer contracts, all AgentTarget round trips, Hooks, LWC MCP protocol and boundary behavior, Windows CodeGraph path forwarding, six native release targets, archive checksums, and post-release npm-installer smoke testing.
Full changelog: v0.13.5...v0.14.6