Skip to content

CLI

The enclave command line interface provides a functional way to interact with the enclave agent. When installed, the CLI can be interacted with using the enclave binary. For linux and darwin, the enclave binary is automatically added to the path when the agent is installed. On windows, the binary can be found under C:\ProgramData\enclave\enclave.exe.

This document does not cover all the available commands. For a full list of commands, run enclave --help.

Examples

Get the help menu for the CLI.

bash
enclave --help

Get the version of your agent and installed plugins.

bash
enclave version

Register your agent

bash
enclave auth register

View the status of the agent

bash
enclave status

Refresh your networking token

bash
enclave auth refresh

Logout of your current agent

bash
enclave auth logout

help

Display help for the commands.

update

Update plugins if an update is needed.

status

Get the status of the agent.

FlagDescription
-a, --allSee all agents that you are connected to.
--healthcheckPerform a healthcheck on the agent. Returns a 0 status code if the agent is authenticated and a 1 if the agent is authenticated.

auth status

View the authentication status of your agent.

auth register

Start the agent. Without any flags, it will prompt to authenticate and choose your agent.

FlagDescription
--registration-code <registration-code>Authenticate using a registration code.
--token <agent-token>Authenticate using an agent token.
--emc-urlEndpoint of the EMC to interact with. This endpoint will be cached.

auth activate

Activate an agent with an activation code.

FlagDescription
--code <code>Activation code.

auth login

Login to the agent with existing credentials.

auth refresh

Refresh your network authentication token if it expires.

auth logout

Logout of your session.

auth clear

Clear your cached authentication credentials.

logs

View logs from the agent.

FlagDescription
-f, --followTail the logs.
-l, --limitNumber of logs to return (default: 100).
-v, --verboseOutput verbose logs.