@glash/cli 0.2.16 → 0.2.19

package/README.md

@@ -2,12 +2,64 @@
 
 The official command-line interface for [glashDB](https://glashdb.com).
 
+## Install
+
+Pick whichever install style you prefer — all four produce the same `glash` command:
+
+```bash
+# Short-name (recommended)
+npm install -g glash
+
+# Scoped package
+npm install -g @glash/cli@latest
+
+# pnpm / yarn / bun
+pnpm add -g glash
+yarn global add glash
+bun add -g glash
+
+# No install — run on demand
+npx -y glash deploy
 ```
-npm install -g @glash/cli
+
+Then:
+
+```bash
 glash login
 glash deploy
 ```
 
+### `glash: command not found`
+
+If npm says the install completed but your shell can't find `glash`, your npm
+global `bin` folder isn't on `PATH`. Fix it once:
+
+```bash
+npm list -g glash --depth=0          # confirm install
+ls -la "$(npm prefix -g)/bin/glash"  # confirm bin exists
+echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+hash -r
+glash --version
+```
+
+On macOS with Homebrew Node, the global prefix is usually
+`/opt/homebrew/bin` (Apple Silicon) or `/usr/local/bin` (Intel) — both are
+typically already on `PATH`. With `nvm`, re-run `nvm use` in new shells or
+add `nvm use --default` to your shell init.
+
+### EACCES / permission errors
+
+Don't `sudo npm install -g`. Instead, point npm at a user-owned prefix:
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix ~/.npm-global
+echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+npm install -g glash
+```
+
 ## Commands
 
 | Command | Purpose |

package/commands/deploy.mjs

@@ -123,7 +123,8 @@ export async function deploy({ flags }) {
   let projectId;
   try { projectId = await resolveProjectId(flags); } catch (e) { return fail(e.message); }
 
-  const commitHash = flags.commit || currentCommit();
+  const remoteDeploy = Boolean(flags.git || flags.repo || flags.remote);
+  const commitHash = flags.commit || (remoteDeploy ? undefined : currentCommit());
   const gitBranch = flags.branch || currentBranch();
   const target = flags.prod || flags.production ? 'production' : (flags.target || 'production');
 
@@ -137,7 +138,7 @@ export async function deploy({ flags }) {
     }
   }
   
-  if (!flags.git && !flags.repo && !flags.remote) {
+  if (!remoteDeploy) {
     info(color.dim(`→ uploading local source for project ${projectId} (${target})`));
     const zipPath = join(tmpdir(), `glash-deploy-${Date.now()}.zip`);
     try {

package/lib/version.mjs

@@ -1 +1 @@
-export const VERSION = '0.2.16';
+export const VERSION = '0.2.19';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glash/cli",
-  "version": "0.2.16",
+  "version": "0.2.19",
   "description": "glashDB command-line interface — deploy projects, pull source + env, manage env vars.",
   "license": "Apache-2.0",
   "homepage": "https://glashdb.com",