.. _ref_commands_names:

names
=====

An overview of names you have registered to publish in Charmhub.

  $ charmcraft names
  Name                Type    Visibility    Status
  sabdfl-hello-world  charm   public        registered

Visibility and status are shown for each name. `public` items can be
seen by any user, while `private` items are only for you and the
other accounts with permission to collaborate on that specific name.

The --include-collaborations option can be included to also list those
names you collaborate with; in that case the publisher will be included
in the output.

Listing names will take you through login if needed.


Usage
-----

:command:`charmcraft names [options]`


Options
-------

``--format``
   Produce the result in the specified format (currently only 'json').
``--include-collaborations``
   Include the names you are a collaborator of.

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.