There is a collection of command line tools to communicate with a running program instance.

Common command line parameters are:

-n <node>
supply a way to connect to the process. It can be a UNIX socket or a network address in the form host:port.
-u <user>
authenticate with the given user name. You will be asked to enter the password before the connection is made.

On Linux the tools are found in /opt/neobotix/pilot-core/bin/ or /opt/neobotix/pilot-gtkgui/bin/. On Windows the tools are found in the bin folder.


To execute a custom Lua Script on the platform:

pilot_execute -n localhost:5555 -u neo-admin -f my_script.lua

Above command will run until the script exits. To return immediately add the -a option.

Requires permission UPLOAD_SCRIPT.


To watch the battery level and optionally shut down the platform when below a certain level.

pilot_battery_watchdog -n localhost:5555 -l 10
pilot_battery_watchdog -n localhost:5555 -s 0.42 -u neo-admin

Shutting down the platform (-s switch) requires permission HOST_SHUTDOWN. For simply watching the battery level, no login is needed.


To change / set a password:

vnxpasswd -c config/local/ -u neo-admin


To call a method on a module:

vnxservice -n localhost:5555 -u neo-user -x HybridPlanner move_to_station Station1 {"max_velocity": 0.5}

To get an overview of available methods:

vnxservice -n localhost:5555 -i HybridPlanner


To convert a *.dat, *.grid or *.road file to JSON:

vnxread -f my_road_map.road


If you have graphviz installed, you can visualize the running modules and their topics.

To create a graph of a running VNX process:

vnxgraph -n localhost:5555 >
dot -Tsvg > graph.svg