aprovan

The aprovan product repo: the workspace chat app, widget compiler/editor packages, and the patchwork runtime for building generative UI experiences.

This repository is also packaged as a Cursor / Claude MCP plugin at the repo root (Streamable HTTP → https://aprovan.com/api/mcp), with a Cursor marketplace manifest at .cursor-plugin/marketplace.json. See PLUGIN.md.

Architecture

• @aprovan/patchwork is the MCP-only runtime client.
• @aprovan/patchwork-mcp publishes Patchwork widgets as MCP Apps and forwards toolbox calls to the configured Streamable HTTP MCP endpoint.
• @aprovan/patchwork-web is the static /chat/ browser shell. It calls the gateway directly and stores workspace files in OPFS.
• Compiler, editor, image, and Bobbin packages remain framework-neutral.

Local development requires only the web shell and a gateway:

GATEWAY_URL=http://localhost:4000 pnpm --filter @aprovan/patchwork-web dev

Cicadas

Install Cicadas

$> uv venv .venv
$> source .venv/bin/activate
$> uv pip install aprovan-cicadas
$> cicadas

License

MIT © Aprovan Labs.