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 [email protected]: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