Shenvy Logo

Documentation

Master the Shenvy CLI and manage your environment variables like a pro.

Quick Start

Get up and running with Shenvy in less than 2 minutes.

1. Install the CLI

# Install via npm (recommended):

npm install -g @shenvy/cli

Alternatively, if you have Go installed: go install github.com/shenvy-io/shenvy-cli@latest or download a pre-built binary from the GitHub releases page.

2. Login

shenvy login

3. Push your first file

shenvy init
shenvy add .env.development
shenvy push

CLI Reference

Command Description
shenvy login Authenticate with your Shenvy account via browser.
shenvy logout Sign out and clear local credentials.
shenvy init Initialize a new project in the current directory.
shenvy add <file> Add a .env file to be tracked by Shenvy.
shenvy push Encrypt and push local changes to the cloud.
shenvy pull Pull and decrypt updates from the cloud.
shenvy run -- <cmd> Run a command with environment variables loaded.
shenvy status Show project status and tracked files.
shenvy plan Show current subscription plan and usage.
shenvy project list List all projects you have access to.
shenvy team create <name> Create a new team.
shenvy member invite <email> Invite a user to the current team.
shenvy env delete <name> Delete an environment from the current project.
shenvy env versions List version history for the current environment.
shenvy timeline Show the full audit timeline for the current project.

Troubleshooting

CLI not found after install

Run npm install -g @shenvy/cli and ensure your npm global bin directory is on your PATH. You can check with npm bin -g and add it to your shell profile if needed.

Authentication errors

Run shenvy login to refresh your session. If the browser window does not open, check that your default browser is configured correctly.

Push rejected — permission denied

You need MEMBER or ADMIN role to push to a project. Ask your team admin to update your role in the Shenvy dashboard.