@morphql/cli

The command-line interface for MorphQL. Transform structural data (JSON, XML, CSV, etc.) directly from your terminal using declarative queries.

Key Features

• 🏎️ Fast Execution: Compiles queries to optimized native JavaScript functions.
• 📂 Batch Processing: Transform entire directories of files in one command.
• 👁️ Watch Mode: Real-time directory monitoring and automatic transformation.
• 📊 Structured Logging: Human-readable text or machine-parsable json output.
• 🧩 Lightweight: Minimal dependencies, leveraging Node.js native modules where possible.

Installation

npm install -g @morphql/cli

Basic Usage

Single File (Default)

# Inline transformation
echo '{"name":"Alice"}' | morphql -q "from json to xml"

# File-to-file
morphql --from data.json --to output.xml -q "from json to xml"

Batch Processing

morphql batch \
  -q "from xml to json transform set status = 'processed'" \
  --in ./inbox \
  --out ./outbox \
  --pattern "*.xml"

Watch Mode

morphql watch \
  -q "from csv to json" \
  --in ./incoming \
  --out ./processed \
  --delete

Options Summary

| Feature | Example | Description | | :----------- | :--------------------- | :----------------------------------------------- | | Patterm | --pattern "*.json" | Filter which files to process. | | Archive | --done-dir ./done | Move files here after success. | | Error | --error-dir ./err | Move files here on failure. | | Cleanup | --delete | Remove source files after successful processing. | | Logging | --log-format json | Output JSONL for automated monitoring. | | PID File | --pid-file morph.pid | Write process PID for service management. |

Learn More

• 👉 Official Documentation
• 🏠 Main Repository

License

MIT