zMesh CLI

Manage your entire zMesh backend from the terminal — databases, edge functions, storage, and environment variables.

📦

Available on PyPI

Install with pip install zmesh-cli — requires Python 3.11+. The CLI command is zmesh.

Quick Start

Terminal
# Install
pip install zmesh-cli

# Login
zmesh login

# Create a project
zmesh init --name "My App"

# Create a table
zmesh database query "CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  name TEXT NOT NULL,
  email TEXT UNIQUE
)"

# Deploy a function
zmesh functions deploy ./handler.js

# Upload a file
zmesh storage upload ./logo.png --path assets/logo.png

Command Groups

🔑 Authentication

zmesh login — Authenticate

zmesh logout — Clear credentials

zmesh whoami — Current user

📁 Projects

zmesh init — Create new project

zmesh link — Link existing project

zmesh projects — List all projects

🗄️ Database

zmesh database tables — List tables

zmesh database query — Run SQL

zmesh database migrate — Run migration

zmesh database seed — Seed from JSON

⚡ Functions

zmesh functions deploy — Deploy JS/Python

zmesh functions invoke — Test a function

zmesh functions logs — View logs

zmesh functions list — List all

📦 Storage

zmesh storage upload — Upload file

zmesh storage download — Download file

zmesh storage list — List files

zmesh storage delete — Remove file

🔧 Environment

zmesh env --list — List vars

zmesh env --set — Set variable

zmesh env --unset — Remove variable

Configuration

LocationPurpose
~/.zmesh/config.jsonGlobal — API URL, auth token
.zmesh/config.jsonLocal — linked project & org
.zmesh/.envFunction environment variables