npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@facets-cloud/facetsctlv3

v1.1.6

Published

Facets CLI

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

facetsdevfacetsdev

Keywords

facetsctlfacetscli

Readme

Configuration

facetsctl requires a connection to docker for all actions involving docker. Ensure that you have docker running on the system where facetsctl is running.

System requirements

Supported node versions: >= 12.0.0

Usage

$ npm install -g @facets-cloud/facetsctlv3
$ facetsctl COMMAND
running command...
$ facetsctl (--version)
@facets-cloud/facetsctlv3/1.1.6 linux-x64 node-v20.19.4
$ facetsctl --help [COMMAND]
USAGE
  $ facetsctl COMMAND
...

Commands

facetsctl artifact init

Initialize artifact information

USAGE
  $ facetsctl artifact init -p <value> -a <value> [-s <value> | -c <value>]

FLAGS
  -a, --artifactory=<value>     (required) Artifactory name
  -c, --ci-integration=<value>  CI Integration Name
  -p, --project=<value>         (required) Project name
  -s, --service=<value>         Service name

DESCRIPTION
  Initialize artifact information

EXAMPLES
  $ facetsctl artifact init --project my-project --service my-service --artifactory my-artifactory
  Created artifact-info.facets.yaml

See code: src/commands/artifact/init.ts

facetsctl artifact push

Push a Docker image to the configured artifact repository

USAGE
  $ facetsctl artifact push -d <value>

FLAGS
  -d, --docker-image=<value>  (required) URL of the Docker image to push

DESCRIPTION
  Push a Docker image to the configured artifact repository

EXAMPLES
  $ facetsctl artifact push --docker-image my-docker-image:latest
  Successfully pushed my-docker-image:latest

See code: src/commands/artifact/push.ts

facetsctl artifact register

Register a Docker image with a specified type and value

USAGE
  $ facetsctl artifact register -t GIT_REF|ENVIRONMENT|RELEASE_STREAM -i <value> -v <value> [-r <value>]

FLAGS
  -i, --docker-image=<value>  (required) Docker image to register
  -r, --runId=<value>         Optional run ID to corelate to your CI system, else it will be time
  -t, --type=<option>         (required) Type (GIT_REF, ENVIRONMENT, RELEASE_STREAM)
                              <options: GIT_REF|ENVIRONMENT|RELEASE_STREAM>
  -v, --value=<value>         (required) Value of the specified type

DESCRIPTION
  Register a Docker image with a specified type and value

EXAMPLES
  $ facetsctl artifact register --type GIT_REF --docker-image my-docker-image:latest --value my-git-ref
  Successfully registered my-docker-image:latest
  Check out the registered build at: https://example.com/builds/1234

See code: src/commands/artifact/register.ts

facetsctl artifact upload

Upload any type of application build file to the Facets Control Plane

USAGE
  $ facetsctl artifact upload -t GIT_REF|ENVIRONMENT|RELEASE_STREAM -f <value> -v <value> [-r <value>]

FLAGS
  -f, --file-path=<value>  (required) path to the application build file (e.g., WAR, JAR, ZIP) on your local system
  -r, --runId=<value>      Optional run ID to corelate to your CI system, else it will be time
  -t, --type=<option>      (required) Type (GIT_REF, ENVIRONMENT, RELEASE_STREAM)
                           <options: GIT_REF|ENVIRONMENT|RELEASE_STREAM>
  -v, --value=<value>      (required) Value of the specified type

DESCRIPTION
  Upload any type of application build file to the Facets Control Plane

EXAMPLES
  $ facetsctl artifact upload --type GIT_REF --file-path file-to-upload --value my-git-ref
        Successfully uploaded the file file-to-upload
        Check out the registered build at: https://example.com/builds/1234

See code: src/commands/artifact/upload.ts

facetsctl cluster manage

Interactive management of Kubernetes clusters with advanced functionality

USAGE
  $ facetsctl cluster manage [-a] [-s <value>] [-r] [-d] [-v]

FLAGS
  -a, --all             Process all available clusters
  -d, --download        Download kubeconfig files for selected clusters
  -r, --refresh         Refresh kubernetes credentials for selected clusters
  -s, --search=<value>  Search for specific clusters by name, ID, or stack name
  -v, --verbose         Show detailed output and metrics

DESCRIPTION
  Interactive management of Kubernetes clusters with advanced functionality

EXAMPLES
  $ facetsctl cluster manage

  $ facetsctl cluster manage --all

  $ facetsctl cluster manage --search production

  $ facetsctl cluster manage --all --refresh

  $ facetsctl cluster manage --all --download

See code: src/commands/cluster/manage.ts

facetsctl help [COMMAND]

Display help for facetsctl.

USAGE
  $ facetsctl help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for facetsctl.

See code: @oclif/plugin-help

facetsctl login

Log in to the Facets control plane

USAGE
  $ facetsctl login -u <value> -t <value> -f <value>

FLAGS
  -f, --facets-url=<value>  (required) URL of the Control plane
  -t, --token=<value>       (required) Personal token
  -u, --username=<value>    (required) Username

DESCRIPTION
  Log in to the Facets control plane

EXAMPLES
  $ facetsctl login --username my-user --token my-token --facets-url https://facets-control-plane.example.com
  Logged in successfully

See code: src/commands/login.ts

facetsctl release sync APPS

Sync out-of-sync apps to match their desired state with the deployed state

USAGE
  $ facetsctl release sync APPS -p <value> -e <value>

ARGUMENTS
  APPS  List of app names to sync (comma-separated | example: ... sync app1,app2,app3 -p ...)

FLAGS
  -e, --environment=<value>  (required) Environment name
  -p, --project=<value>      (required) Project name

DESCRIPTION
  Sync out-of-sync apps to match their desired state with the deployed state

See code: src/commands/release/sync.ts

facetsctl facetsctl release wait <apps> -p <value> -e <value> [--sync]

Wait for the sync status of the specified apps, and trigger sync if --sync is provided

USAGE
  $ facetsctl release wait facetsctl  <apps> -p <value> -e <value> [--sync]

ARGUMENTS
  APPS  List of app names to wait for (comma-separated | example: ... sync app1,app2,app3 -p ...)

FLAGS
  -e, --environment=<value>  (required) Environment name
  -p, --project=<value>      (required) Project name
      --sync                 Trigger a sync if apps are out-of-sync

DESCRIPTION
  Wait for the sync status of the specified apps, and trigger sync if --sync is provided

See code: src/commands/release/wait.ts

facetsctl artifact init

Initialize artifact information

USAGE
  $ facetsctl artifact init -p <value> -s <value> -a <value>

FLAGS
  -a, --artifactory=<value>  (required) Artifactory name
  -p, --project=<value>      (required) Project name
  -s, --service=<value>      (required) Service name

DESCRIPTION
  Initialize artifact information

EXAMPLES
  $ facetsctl artifact init --project my-project --service my-service --artifactory my-artifactory
  Created artifact-info.facets.yaml

See code: src/commands/artifact/init.ts

facetsctl artifact push

Push a Docker image to the configured artifact repository

USAGE
  $ facetsctl artifact push -d <value>

FLAGS
  -d, --docker-image=<value>  (required) URL of the Docker image to push

DESCRIPTION
  Push a Docker image to the configured artifact repository

EXAMPLES
  $ facetsctl artifact push --docker-image my-docker-image:latest
  Successfully pushed my-docker-image:latest

See code: src/commands/artifact/push.ts

facetsctl artifact register

Register a Docker image with a specified type and value

USAGE
  $ facetsctl artifact register -t GIT_REF|ENVIRONMENT|RELEASE_STREAM -i <value> -v <value> [-r <value>]

FLAGS
  -i, --docker-image=<value>  (required) Docker image to register
  -r, --runId=<value>         Optional run ID to corelate to your CI system, else it will be time
  -t, --type=<option>         (required) Type (GIT_REF, ENVIRONMENT, RELEASE_STREAM)
                              <options: GIT_REF|ENVIRONMENT|RELEASE_STREAM>
  -v, --value=<value>         (required) Value of the specified type

DESCRIPTION
  Register a Docker image with a specified type and value

EXAMPLES
  $ facetsctl artifact register --type GIT_REF --docker-image my-docker-image:latest --value my-git-ref
  Successfully registered my-docker-image:latest
  Check out the registered build at: https://example.com/builds/1234

See code: src/commands/artifact/register.ts

facetsctl cluster manage

Interactive management of Kubernetes clusters with advanced functionality.

USAGE
  $ facetsctl cluster manage [-a] [-s <value>] [-r] [-d]

FLAGS
  -a, --all            Process all available clusters
  -s, --search=<value> Search for specific clusters by name, ID, or stack name
  -r, --refresh        Refresh kubernetes credentials for selected clusters
  -d, --download       Download kubeconfig files for selected clusters

DESCRIPTION
  Interactive management of Kubernetes clusters with advanced functionality.
  
  This command provides a unified interface to:
  1. List all clusters from the control plane
  2. Search for specific clusters if needed
  3. Select one or more clusters from the list
  4. Choose to either download kubeconfig files or refresh Kubernetes credentials for the selected clusters
  5. Execute operations in parallel for better performance
  
  The command handles error reporting and provides detailed status information for each operation.
  Clusters without available kubeconfig files or credentials will be reported properly without failing.

EXAMPLES
  $ facetsctl cluster manage
  $ facetsctl cluster manage --all
  $ facetsctl cluster manage --search production
  $ facetsctl cluster manage --all --refresh
  $ facetsctl cluster manage --all --download

See code: src/commands/cluster/manage.ts

facetsctl help [COMMAND]

Display help for facetsctl.

USAGE
  $ facetsctl help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for facetsctl.

See code: @oclif/plugin-help

facetsctl login

Log in to the Facets control plane

USAGE
  $ facetsctl login -u <value> -t <value> -f <value>

FLAGS
  -f, --facets-url=<value>  (required) URL of the Control plane
  -t, --token=<value>       (required) Personal token
  -u, --username=<value>    (required) Username

DESCRIPTION
  Log in to the Facets control plane

EXAMPLES
  $ facetsctl login --username my-user --token my-token --facets-url https://facets-control-plane.example.com
  Logged in successfully

See code: src/commands/login.ts

facetsctl release sync

Sync out-of-sync apps to match their desired state with the deployed state

USAGE
  $ facetsctl release sync <apps> -p <value> -e <value>

ARGUMENTS
  <apps>: List of app names to sync (comma-separated | example: ... sync app1,app2,app3 -p ...)

FLAGS
  -e, --environment=<value>  (required) Environment name
  -p, --project=<value>      (required) Project name

DESCRIPTION
  Sync out-of-sync apps to match their desired state with the deployed state

EXAMPLES
  $ facetsctl release sync my-resource1,my-resource2 -p my-project -e my-environment

See code: src/commands/release/sync.ts

facetsctl release wait

Wait for the sync status of the specified apps, and trigger sync if --sync is provided

USAGE
  $ facetsctl release wait <apps> -p <value> -e <value> [--sync]

ARGUMENTS
  <apps>: List of app names to wait for (comma-separated | example: ... sync app1,app2,app3 -p ...)

FLAGS
  -e, --environment=<value>  (required) Environment name
  -p, --project=<value>      (required) Project name
      --sync                 Trigger a sync if apps are out-of-sync

DESCRIPTION
  Wait for the sync status of the specified apps, and trigger sync if --sync is provided

EXAMPLES
  $ facetsctl release wait my-resource1,my-resource2 -p my-project -e my-environment 
  $ facetsctl release wait my-resource1,my-resource2 -p my-project -e my-environment --sync

See code: src/commands/release/wait.ts