mercur-cli

Manage Mercur projects by creating, initializing, and manipulating blocks.

2|1|Updated May 20, 2026
One-click install
npx skills add https://github.com/amo-tech-ai/mdeapp --skill mercur-cli-amo-tech-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mercur-cli
Source: https://github.com/amo-tech-ai/mdeapp/tree/main/commerce/mercur/.claude/skills/mercur-cli
Command: npx skills add https://github.com/amo-tech-ai/mdeapp --skill mercur-cli-amo-tech-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill assists users in effectively utilizing the Mercur CLI commands to create, initialize, search, view, add, and compare blocks within a Mercur project.

Core Features & Use Cases

  • Project Creation: Quickly set up new Mercur projects with the create command.
  • Initialization: Initialize blocks.json for an existing project with init.
  • Block Management: Perform searches, view, add, and diff blocks using search, view, add, and diff.
  • Use Case: Suppose you are working on a Mercur project and want to add a new block. Use the search and view commands to find and examine the block before installing it with add.

Quick Start

Search for a block in your Mercur project and view its details using the npx @mercurjs/cli@latest search --query <keyword> and npx @mercurjs/cli@latest view <block-name> commands.

Frequently Asked Questions about mercur-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize blocks.json for an existing Mercur project?

To initialize blocks.json for an existing Mercur project, run the init command via the Mercur CLI. This generates the necessary block configuration file to enable block-based development within the Mercur ecosystem.

What is the best way to search for and add a block to a Mercur project?

The best way to add a block to a Mercur project is using the search and add commands. Run the search command with a keyword query to find blocks, then use the add command to install the specific block into your project.

Can I compare block versions when managing a Mercur project?

Yes, you can compare block versions when managing a Mercur project by using the diff command. This allows you to view differences between blocks, ensuring you select the correct block configuration before installation.

How do I create a new Mercur project from the command line?

To create a new Mercur project from the command line, use the create command provided by the Mercur CLI. This quickly sets up the foundational project structure for block-based development.

How can I view the details of a specific block before installing it?

To view the details of a specific block before installing it, use the view command with the block name. This examines the block contents and configuration, ensuring it meets your project requirements before you add it.