XtraSync CLI

Secure Runtime Secret Injection

XtraSync CLI is a powerful command-line tool designed to seamlessly and securely inject environment variables into your application at runtime. Say goodbye to scattered .env files and leaked secrets—XtraSync brings central secret management directly to your local development and CI/CD pipelines.

Installation

Install the CLI globally via npm:

npm install -g xtra-cli

Quick Start

1. Login and Authenticate: Authenticate your machine with the XtraSecurity platform. You can log in via Single Sign-On (SSO), email, or an Access Key.

   xtra login

2. Initialize a Project: Bootstrap your project by creating an .xtrarc configuration file.

   xtra init

3. Run your Application securely: Inject secrets directly into your running process without ever touching a disk.

   xtra run npm start

Core Commands

xtra run [command]

Run a command with secrets injected at runtime.

# Example: Inject production secrets and run the build script
xtra run -e production npm run build

xtra secrets list

List all secrets available for a given project and environment.

xtra secrets list -e staging

xtra secrets set [KEY=VALUE...]

Set one or more secrets.

xtra secrets set API_KEY=123x DB_PASS=secret

xtra env clone

Clone secrets from one environment to another.

xtra env clone --from development --to production

xtra local sync

Pull cloud secrets to a .env.local file for offline development.

xtra local sync

Advanced Usage

• CI/CD Integration (xtra ci): Run headless operations in your pipelines.
• Auditing (xtra logs): View your local audit trails and access history.
• Profiles (xtra profile): Manage multiple connection setups and environments.
• TUI Dashboard (xtra ui): Launch an interactive terminal user interface to manage secrets visually.

Help & Documentation

For a complete list of commands and options, run:

xtra --help

To see help for a specific command, use:

xtra <command> --help