JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2
  • Score
    100M100P100Q36384F
  • License MIT

ZVault CLI - ZenVault Developer Experience Dashboard. Clone repos, inject env vars, open docs with one command.

Package Exports

  • zvault
  • zvault/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (zvault) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ZVault CLI

CLI tool for the ZenVault Developer Experience Dashboard.

Installation

# Install globally from npm
npm install -g zvault

# Or use directly with npx
npx zvault

Prerequisites

GitHub Authentication (for private repos)

If you're cloning private repositories, you need to be authenticated with GitHub:

# Install GitHub CLI
sudo apt install gh  # Linux
brew install gh      # macOS

# Login to GitHub
gh auth login

Or use SSH URLs for your repositories instead of HTTPS:

  • Change https://github.com/user/repo.git to git@github.com:user/repo.git

Usage

Login

Authenticate with your ZVault access token:

npx zvault login

This will prompt you for:

  1. Your access token (generate from Settings > Access Tokens)
  2. The API URL (default: https://zenvault.tech)

Pull

Pull a project with environment variables and resources:

npx zvault pull <project-name>

# Specify environment
npx zvault pull backend --env production

# Auto-fix .gitignore for security
npx zvault pull --auto-gitignore

This command will:

  1. Clone the repository (or pull if exists)
  2. Create a .env file with decrypted environment variables
  3. Add .env to .gitignore (with --auto-gitignore)
  4. Open all linked resources in your browser

Push

Push local environment variables to ZVault:

npx zvault push

Refresh

Sync latest environment variables:

npx zvault refresh

Status

Check for environment variable drift:

npx zvault status

Run

Run a command with secrets injected:

npx zvault run -- npm start

Configuration

Configuration is stored in ~/.zvault/config.json:

{
  "token": "zvl_...",
  "apiUrl": "https://zenvault.tech"
}

Troubleshooting

"Username for 'https://github.com'" prompt

This means GitHub authentication is needed. See the Prerequisites section above.

".env is not in your .gitignore"

This is a security feature. Use --auto-gitignore flag to automatically fix:

npx zvault pull --auto-gitignore