@xpell/vibe

XVibe is the server-side generation, planning, intent, and structured editing module for Xpell.

It provides the xvibe XModule used by Vibe-enabled Xpell servers for application generation, planning flows, Project Memory-aware guidance, conversation state, artifact execution, and deterministic structured view editing.

Status

@xpell/vibe is distributed as a separate package from @xpell/node.

Generic Xpell servers can use @xpell/node without installing or loading XVibe. Vibe-enabled products install this package directly and compose it explicitly:

import { XNode } from "@xpell/node";
import { XVibeModule } from "@xpell/vibe";

const node = new XNode();

await node.start({
  _modules: [
    new XVibeModule()
  ]
});

What XVibe Does

XVibe is an orchestration layer for AI-assisted Xpell development. It is responsible for:

• intent analysis through ordered XVibe processors;
• app and view planning;
• Project Memory-aware recommendations;
• conversation and run archive management;
• artifact planning and execution;
• deterministic structured view edits through Xpell module commands;
• mutation-plan execution through explicit XCommands;
• integration with Xpell modules such as server-xvm, xai, entity-manager, module-creator, and wormholes through _x.execute(...).

XVibe is not:

• a browser UI runtime;
• a database;
• a replacement for @xpell/node;
• a standalone app host;
• an implicit dependency of generic Xpell servers.

Package Usage

Install it in Vibe-enabled server projects:

pnpm add @xpell/vibe

Then register XVibeModule explicitly with XNode.start({ _modules }).

Applications that do not need Vibe should not install this package.

Licensing

The basic license for @xpell/vibe is:

• PolyForm Noncommercial License 1.0.0

There is also a draft XPell community license document:

• XPell Community License 1.0 Draft

The community license file is a draft only. It is not legal advice and should be reviewed by qualified counsel before production use.

Practical License Summary

The intended product direction is:

Free to build with. Not free to build a competitor.

The community-license draft is intended to allow building ordinary applications with XVibe, including commercial applications, while prohibiting redistribution of XVibe itself, hosted development services, and competing developer platforms without a commercial license.

Until a final community license is adopted, the controlling package license is the license file shipped with this package.

Commercial Licensing

Uses not permitted by the package license require a separate commercial license from XPell.

Examples that may require commercial licensing include:

• redistributing XVibe;
• embedding XVibe into another developer product;
• offering XVibe or XVibe-derived developer-tool functionality as a hosted service;
• building a competing application builder, vibe-coding platform, AI coding tool, SDK, framework, IDE, agent-building platform, or visual development tool using XVibe.

Contact XPell for commercial licensing terms.

Development

Build the package:

pnpm build

The package exports:

• @xpell/vibe
• @xpell/vibe/XVIBE
• @xpell/vibe/XVIBE/*

Notes

This package expects to run inside an Xpell server runtime. It communicates with other Xpell capabilities through _x.execute(...) rather than direct server implementation imports.