Quickstart

1 — Install

# system-wide install
curl -fsSL https://syncenv.yuvrajthapa.com/install.sh | sudo bash

# or user-only install (no sudo)
curl -fsSL https://syncenv.yuvrajthapa.com/install.sh | bash -s -- --user

The installer detects your platform, downloads the binary, and places it in your PATH. Works on Linux, macOS, and WSL2.

2 — Initialize

# verify installation
syncenv --version

# initialize (uses trusted-owner-ssh mode by default)
syncenv init

This creates the configuration directory at ~/.config/syncenv/ and generates any keys needed for your security mode.

3 — Add secrets & sync

# add your first secret
syncenv add OPENAI_API_KEY="sk-abc123xyz"

# discover other machines on your network
syncenv discover

# sync with all discovered peers
syncenv sync

4 — Automate (optional)

# install a cron job to sync every 30 minutes
syncenv cron --install

# or load secrets automatically on shell startup
# add this to ~/.bashrc or ~/.zshrc:
eval "$(syncenv load 2>/dev/null)"

Prerequisites

• Go 1.24+ — only needed if building from source
• SSH client — for trusted-owner-ssh mode (installed by default on most systems)
• mDNS support — Avahi on Linux (sudo apt install avahi-daemon avahi-utils), Bonjour on macOS (built-in)

Build from source

git clone https://github.com/yuvraj1107thapa/syncenv.git
cd syncenv
make build
make test
sudo make install        # system-wide
# or: make install-user  # user-only

Upgrade & uninstall

# upgrade — re-run the installer
curl -fsSL https://syncenv.yuvrajthapa.com/install.sh | sudo bash

# uninstall
syncenv service uninstall
rm -rf ~/.config/syncenv
sudo rm -f /usr/local/bin/syncenv