embed-ui for RetailCRM extensions CLI
@retailcrm/embed-ui
RetailCRM's official CLI and package set for interface extensions: project scaffolding, UI components, data contexts and ready MCP setup for agents
- 1 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a generator via npx that scaffolds an extension project and installs dependencies
- Can add AGENTS.md, skills and an .mcp.json with RetailCRM MCP packages to the project
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/retailcrm-embed-uiDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a generator via npx that scaffolds an extension project and installs dependencies
- Can add AGENTS.md, skills and an .mcp.json with RetailCRM MCP packages to the project
This is third-party code. Review the repository files before installing.
What it does
The @retailcrm/embed-ui package ships an embed-ui binary that scaffolds a RetailCRM extension frontend via npx: package.json, Vite, TypeScript and ESLint configs, starter files for an endpoint worker, a settings page and an order widget, and can add AGENTS.md, project-level skills under .agents/skills, and a .mcp.json for the v1-contexts and v1-endpoint packages. The separate v1-* packages provide UI components, reactive contexts for the RetailCRM JS API, an endpoint API for embedded pages, a sandbox for local testing, and base type declarations. The v1-contexts and v1-endpoint MCP resources give an agent AI-readable descriptions of available contexts, actions and widget embedding targets.
Who it is for. For developers building RetailCRM interface extensions who want an agent-friendly setup from the start.
Good fit when
- You are starting a RetailCRM interface extension from scratch
- You need to add v1-components, v1-contexts or v1-endpoint packages to an existing frontend
- You want MCP resources and skills so an agent understands RetailCRM contexts, actions and widget embedding targets
Not a fit when
- You need to work with RetailCRM data directly (orders, clients): this tool is for building the extensions themselves, not for CRM operations
- You need a non-Vue stack: init adds vue, pinia and vue-i18n dependencies
Example request
Scaffold a new RetailCRM extension in the web folder with an order-card widget and set up MCP for Claude CodeLimitations
The testing package is not yet added through the public init command. User-level MCP registration via codex mcp add is deliberately not automatic, to avoid conflicts between projects on different package versions; configs are generated at the project level. Junie is supported as a client config target but is not in the catalog's agent list.
How to disable. Remove .mcp.json, the .agents/skills directory and the @retailcrm/embed-ui* dependencies from the extension project.
FAQ
What does init-skills create separately from init?
Only project-level skills in .agents/skills/*, without touching dependencies, templates or AGENTS.md, for when you need to update them on their own.
How do I get configs for Cursor or Codex?
With the --mcp-client-configs codex,cursor,junie,vscode flag on init; these are not created by default since they often carry manual edits.
Discussion
No questions or reviews yet.
Related
All RetailCRM toolsRetailCRM plugin for Claude Code and Codex: a remote MCP server with GraphQL access to the CRM and a skill with safe-use rules
RetailCRM MCP on the official PHP client
retailcrm-mcp
44 tools and 2 prompt skills for RetailCRM built on the official PHP client: orders, customers, inventory, payments, tasks and PII-free analytics
RetailCRM plugin for Codex and Claude Code
RetailCRM plugin
The RetailCRM plugin: a remote GraphQL MCP server plus a skill that safely searches the schema and confirms mutations with the user
RetailCRM MCP
retailcrm-mcp
RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5
RetailCRM MCP server
RetailCRM MCP Server
A RetailCRM MCP server with one-click Railway or Render deploy: orders, customers, products, statistics and reference data
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
README in short
The README lists the v1-components, v1-contexts, v1-endpoint, v1-sandbox, v1-testing and v1-types packages, describes the embed-ui CLI with init, init-skills and version-update commands, walks through init's default behavior and the flags controlling files, dependencies, AGENTS.md, project-level skills and MCP setup, and explains the .mcp.json format for Claude Code project scope plus client config generation for Codex, Cursor, Junie and VS Code.