Skip to content

Command-line interface

Common Flags

These flags may be provided with practically any of Confidants' subcommands.

-q,--quiet

Silence most (non-fatal) message output.

-v,--verbose

Immediately sets log-level to trace, producing all possible output.

-h,--help

Display help information for Confidant or one of its' subcommands.

Commands

The command-line interface was crafted manually and meticulously to provide a smooth experience for all users. It is highly recommended to ensure you install the command-line shell completion file for the shell you use if available.

init

Will provide you a sample (local) configuration file in your current directory, or a directory you specify at the end of the command. The sample is documented with comments explaining how the different parts work, though if you need further guidance, see the global and local configuration pages.

Performs the main symlinking action of Confidant, reading your local configuration and applying the links you've declared. If you are unsure about the correctness of your declarations, pass the -d,--dry-run flag alongside the command to simulate the actions that would be taken before really applying them.

config

Allows you to display your configuration and get a birds-eye view of your settings

dump

Pretty-prints your local configuration settings, though you may also pass -g,--global to display the settings of your global configuration instead.

get

Queries your configuration settings given the name of a section, such as repository, links or templates. Also allows you to query nested sections by separating the section names with periods; for example:

confidant config get repository.url
confidant config get templates.config.items

help <command>

Display help information about sub-commands, supported arguments include: init, config, config dump, config get and link.

usage

Display brief command-line usage information.

version

Display brief version information.