CLI

wave-binder-cli

Simple guide to create and edit node JSON files.

What it does

wbcli helps you build and update node JSON files without repetitive manual editing.

Official repository

GitHub: wavebinder/wavebinder-cli

Getting started

Install from npm

Show example 
npm install wave-binder-cli

Run CLI

Show example 
wbcli --help

Commands

  • wbcli wizard: guided wizard (recommended for manual usage).
  • wbcli add <nodeName> <nodeType> [-j file.json] [-f fatherNode]: create a node.
  • wbcli edit <nodeName> [-t nodeType] [-j file.json]: edit a node.

wbcli wizard command flow

The sequence below describes what happens when you run wbcli wizard.

  1. Select the target JSON file (existing or new).
  2. Choose action: Create node (guided) or Edit node (guided).
  3. Confirm prompts and save. Then continue on same file or exit.

Father vs Dependency (important)

Quick rule:
Father is used when a node is part of another node (hierarchical structure, for example object or list).
If you want to change when/from what a node updates, set a dependency (dep).

Father

  • Moves the node inside a container node.
  • Changes position in JSON (protos[] or proto).

Who can be a father?

  • Only COMPLEX or LIST nodes.
  • SINGLE and MULTI cannot be father nodes.
Show example 
# city is created as a child of geoFilters
wbcli add city MULTI -j protonodes.json -f geoFilters

Dependency (dep)

  • Does not change the node position in JSON.
  • Defines from which nodes it takes values or update triggers.
Show example 
# conceptual example:
# city depends on region -> when region changes, city updates
# (configured in dependency menu in add/edit flows)

Essential examples

Show example 
# 1) guided wizard
wbcli wizard

# 2) add top-level node
wbcli add region MULTI -j protonodes.json

# 3) edit node type
wbcli edit region -t SINGLE -j protonodes.json

Important rules

  • Allowed types: SINGLE, MULTI, COMPLEX, LIST.
  • SIMPLE type is invalid and returns an explicit error.
  • If you do not pass -j, interactive file selection starts.
  • JSON file is validated before operations.
If you are new: use wbcli wizard. If you are advanced or scripting: use add/edit directly.