Push from the CLI

Prefer the terminal? The @vydex/cli tool pushes a project straight into your drafts — like git push, but into your Vydex account. From a draft you set a price and publish on the site.

Requires Node 18+ and git on your PATH.

Install — two ways

Option A — global (short vydex command):

npm install -g @vydex/cli
vydex --help

Option B — on demand with npx (no install):

npx @vydex/cli --help

The examples below use the global vydex command. If you prefer npx, just write npx @vydex/cli wherever you see vydex — e.g. npx @vydex/cli push ….

1. Get a token

Go to Settings → Security → CLI access tokens → Generate and copy the vdx_… token (shown once).

2. Log in

vydex login                 # paste the token when prompted
# npx: npx @vydex/cli login

The token is saved to ~/.vydex.json (or pass VYDEX_TOKEN).

3. Push

Run inside a git repo with at least one commit. It uploads git archive HEAD — your tracked files at the current commit.

Folder isn't a git repo yet? One-time setup (this is also the fix for the "No git commit found here" error):

cd my-project
git init
git add -A
git commit -m "init"

Then push:

# new draft
vydex push --title "Analytics dashboard"

# paid draft
vydex push --title "Pro UI kit" --paid --price 29

# a new version of an existing repo
vydex push --repo <repository-id> --message "fix auth"

The command prints the draft URL — open it to add a description, screenshots and tags, then publish. Tokens can be revoked any time on the same settings page.

Good to know: only committed files are uploaded (that's the point — you always publish an exact commit), and .gitignored files like node_modules are never included.