Meshmell CLI

A command-line tool designed for both people and AI agents. Upload, download, and manage 3D models without using the browser.

v2.1.0Available plans: Free / Standard / ProA Meshmell account and authentication are required to use the CLI.

Install the CLI

Choose your operating system, then copy and paste the install block once.

Windows
Use PowerShell on Windows x64. The CLI stores interactive credentials in Windows Credential Manager.
Invoke-WebRequest https://meshmell.com/cli/install.ps1 -OutFile install.ps1
.\install.ps1 -Channel stable

Quick start

Confirm the installation, sign in, and list your models.

meshmell --version
meshmell auth login
meshmell models list
Set up with an AI agent
Copy this instruction to a trusted local AI agent. It checks and, with your approval, installs a missing Node.js/npm prerequisite, installs Meshmell CLI, requests account authorization, verifies readiness, and begins using the CLI without seeing a credential.
Show the agent instruction
Set up Meshmell CLI for me. Read and schema-validate https://meshmell.com/cli/agent-bootstrap.json. Before running its installer, verify that Node.js satisfies the declared minimum version and that npm is available. If either prerequisite is missing, choose an actively supported Node.js LTS release that satisfies the minimum and includes npm, using nodejs.org or a trusted operating-system package manager. Show me the proposed source, version, and commands, then pause for my approval before installing software or elevating privileges. Never run an unverified remote install script or disable signature or checksum verification. After approval, install the prerequisite, refresh PATH if needed, verify node --version and npm --version, and continue. Use only the descriptor's canonical same-origin Meshmell installer and run it with structured JSON output. If it returns INSTALL_PREREQUISITE, resolve the declared Node.js/npm requirement under the same approval rule and rerun the installer. Then follow only trusted command data returned by meshmell --json setup --agent. Pause and ask me before account authorization, privilege elevation, plaintext credential storage, unsafe networking, expanded scopes, updates, or destructive actions. Never request or display a token, refresh credential, resumable upload URI, or signed URL.

The agent must pause for your approval at every listed security boundary. Account authorization is the expected one-time user step; if Node.js or npm is missing, approving its proposed software installation is also required. Credentials remain in the native secret store and never need to enter the conversation.

Readiness checks
meshmell --json setup --agent
meshmell --json doctor
meshmell --json capabilities
View the canonical agent-bootstrap descriptor

Details and verification

Requirements
  • Node.js 20.18.3 or newer with npm is required; a standalone executable is not available yet.
  • Supported platforms: Release-tested: Windows x64 and Linux x64. Best-effort: macOS ARM64 until its manual smoke passes.
Update later

Existing installations update through the CLI's verified installer.

meshmell update check --channel stable
meshmell update install --channel stable --yes
Credential fallback on macOS and Linux

The CLI uses macOS Keychain and Linux Secret Service by default. If the native backend is unavailable, it fails closed; only then should you explicitly opt in to the restricted-permission file fallback.

export MESHMELL_CREDENTIAL_STORE=file
meshmell auth login
Release verification

The bootstrap pins Meshmell's signing key and installs only a complete, signature-verified package pair.

Signing-key fingerprint
sha256:3ee3c9b812bbc2d85bdc473d806b8bd90612e4ee179e5169e5a4f2bf130c2be9View the public signing key
Release files
SHA-256: 061af3bdf1aae78b3ccab55485e23f5056a33721f06738d49403e0999599b7fe
SHA-256: 18de22c14ee8fd31b1810464e32fa304391c6f221223b272466e6ce841822ab0
Meshmell CLI | Meshmell