=========
CLI Usage
=========

The Nube CLI is the primary way to interact with the daemon and manage your data fabric.

Common Commands
===============

Node Management
---------------

Show node health, identity, and peer counts:

.. code-block:: bash

   nube status

Start the daemon in the foreground:

.. code-block:: bash

   nube start

File Operations
---------------

List files in a Nube virtual directory (defaults to root `/`):

.. code-block:: bash

   nube ls /Documents/Work

Upload a local file:

.. code-block:: bash

   nube put /Documents/report.pdf

Download a file by its CID:

.. code-block:: bash

   nube get <CID> /Documents/retrieved-file.pdf

Organize your virtual data inside Nube:

.. code-block:: bash

   nube mkdir /Documents/ProjectA
   nube mv /report.pdf /Documents/ProjectA/report.pdf

Native Bridge
-------------

Nube can open files directly in your system's default applications while keeping them in sync with the fabric.

Open a file for viewing by its CID:

.. code-block:: bash

   nube open <CID> report.pdf

Open a file for editing by its CID (automatically syncs changes back to Nube on save):

.. code-block:: bash

   nube edit <CID> Notes.txt