=============
CLI Reference
=============

    :Author: Rohit Goswami


Synopsis
--------

::

    bless [OPTIONS] -- COMMAND [ARGS...]

Options
-------

``--label <LABEL>``
~~~~~~~~~~~~~~~~~~~

Label for the run. Used in the output filename and MongoDB metadata.

Default: ``default_label``

``--use-mongodb``
~~~~~~~~~~~~~~~~~

Store the gzip log blob in MongoDB after the command finishes.

Requires ``MONGODB_URI`` environment variable.

``--no-timestamp``
~~~~~~~~~~~~~~~~~~

Omit timestamps from stdout output. The gzip file still includes full
timestamps.

Useful for piping to downstream tools that expect clean output.

``--format <FORMAT>``
~~~~~~~~~~~~~~~~~~~~~

Output format for stdout. Values:

- ``log`` (default): ``[TIMESTAMP LEVEL] message``

- ``jsonl``: ``{"ts":"...","level":"INFO","msg":"..."}``

The gzip file always uses the ``log`` format regardless of this setting.

``-o, --output <PATH>``
~~~~~~~~~~~~~~~~~~~~~~~

Output file path. Defaults to ``{label}_{uuid}.log.gz`` in the current directory.

Special values:

- ``-``: skip file output entirely (stdout only)

- Path not ending in ``.gz``: write plain text (no compression)

``--split``
~~~~~~~~~~~

Write separate gzip files for stdout and stderr:

- ``{label}_{uuid}_stdout.log.gz`` -- INFO and below

- ``{label}_{uuid}_stderr.log.gz`` -- WARN and ERROR

``--version``
~~~~~~~~~~~~~

Print version and exit.

Serve mode options
------------------

Available when built with ``--features serve``.

``--serve <ADDR>``
~~~~~~~~~~~~~~~~~~

Start in server mode, listening for capnp RPC connections.

Example: ``--serve :5678``

``--remote <ADDR>``
~~~~~~~~~~~~~~~~~~~

Stream logs to a remote bless server instead of (or in addition to) local files.

Example: ``--remote :5678``

``--local``
~~~~~~~~~~~

When used with ``--remote``, also write a local gzip file.

Exit codes
----------

``bless`` passes through the exit code of the wrapped command. If the command
exits with code 42, ``bless`` exits with code 42.

If ``bless`` itself fails (e.g., cannot create log file), it exits with code 1
and prints the error to stderr.