r3 — R3PLICA CLI

Query the R3PLICA digital replicas catalog from your terminal. Search products, brands, collections, and finishes — built for AI agents, developers, and scripts.

Install

npm install -g r3plica

Requires Node.js 20+.

Quick Start

# Search products
r3 product search "dining table"

# List brands
r3 brand list

# Filter by brand and category
r3 product list --brand "Cattelan Italia" --category table

# Get product details
r3 product get <mongo_id>

# Pipe to jq
r3 product list --limit 5 --json | jq '.[].name'

Commands

Products

r3 product list [--brand X] [--category X] [--collection X] [--designer X] [--year X] [--limit N] [--page N]
r3 product search <query> [--brand X] [--category X] [--designer X] [--year X] [--limit N]
r3 product get <mongo_id>
r3 product stats [--by category|brand|designer|year] [--brand X]
r3 product compare <id1> <id2>

Brands

r3 brand list [--country X] [--limit N]
r3 brand search <query>

Product Collections

Product collections are furniture lines from a brand (e.g., "Tudor" by Cattelan Italia).

r3 product-collection list [--brand X] [--limit N] [--page N] [--sort X] [--order asc|desc]
r3 product-collection search <query>

Finish Collections

Finish collections are sets of material finishes (shaders) — wood types, fabrics, metals, leathers — that can be applied to product parts.

r3 finish-collection list [--brand X] [--category X] [--limit N] [--page N]
r3 finish-collection search <query>
r3 finish-collection get <mongo_id>

Configuration

r3 config show
r3 config set api-url <url>

Default API URL: https://api.r3plica.space/api/r3vault. Override with R3_API_URL environment variable or r3 config set.

Output

• Terminal: formatted table with headers and result count
• Piped: JSON (automatic detection)
• --json: force JSON output
• --pretty: force table output
• --markdown: force markdown table output

# Table output (terminal)
$ r3 brand list --limit 3

  ┌──────────────────┬───────────────────────────┬─────────────────┬────────────┐
  │ ID               │ Name                      │ Country         │ Products   │
  ├──────────────────┼───────────────────────────┼─────────────────┼────────────┤
  │ 0a497f00-cc6f-45 │ Driade                    │ Italy           │ 29         │
  │ 22b4a540-bcf2-4e │ We Are IB                 │ Italy           │ 37         │
  │ ab368a13-6038-41 │ Emu                       │ Italy           │ 26         │
  └──────────────────┴───────────────────────────┴─────────────────┴────────────┘
  3 brands found

# JSON output (piped or --json)
$ r3 brand list --limit 1 --json | jq '.[0].name'
"Driade"

Use with AI Agents

Claude Code / CLAUDE.md

Add to your project's CLAUDE.md:

## R3PLICA Catalog

The `r3` CLI queries the R3PLICA digital replicas catalog. Use it when the user
asks about furniture, finishes, brands, or design products.

- `r3 product search "query"` — search products by text
- `r3 product list --brand X --category X` — filter products
- `r3 product list --designer "Name"` — filter by designer
- `r3 product get <id>` — product details with finish options
- `r3 product stats --by brand` — catalog breakdown
- `r3 product compare <id1> <id2>` — side-by-side comparison
- `r3 brand list` — all available brands
- `r3 finish-collection list --brand X` — available finish collections
- Always use `--json` when processing results programmatically
- Run `r3 --help` for full command reference

MCP Server

The package also includes an MCP server for auto-discovery in Claude Desktop, Cursor, and similar IDEs.

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "r3plica": {
      "command": "r3-mcp"
    }
  }
}

The MCP server exposes the same data through 10 tools: product_list, product_search, product_get, brand_list, brand_search, product_collection_list, product_collection_search, finish_collection_list, finish_collection_search, finish_collection_get.

Examples

# Find Italian brands
r3 brand list --country Italy

# Search chairs, limit to 5 results
r3 product search "chair" --limit 5

# Get all products from a brand
r3 product list --brand "Driade"

# Explore a product collection
r3 product-collection search "Tudor"

# Find products by designer
r3 product list --designer "Philippe Starck"

# Catalog stats
r3 product stats --by brand
r3 product stats --brand "Driade" --by designer

# Compare two products
r3 product compare <id1> <id2>

# Find wood finishes
r3 finish-collection list --category wood

# Script: get all brand names
r3 brand list --json | jq -r '.[].name'

# Script: count products per brand
r3 brand list --json | jq -r '.[].name' | while read brand; do
  count=$(r3 product list --brand "$brand" --json 2>/dev/null | jq length)
  echo "$brand: $count"
done

About R3PLICA

R3PLICA provides certified digital replicas of branded furniture, finishes, and materials to architects, interior designers, and visualization professionals. The catalog includes 60+ premium partner brands including Cattelan Italia, Driade, Poliform, and more.

License

Proprietary - R3PLICA S.r.l.