dweller CLI
A single static binary for Windows, macOS and Linux. It publishes builds, manages store pages, and is safe for scripts, CI and AI agents to drive.
Install
# macOS / Linux
curl -fsSL https://dweller.games/install-cli.sh | sh
# Windows (PowerShell)
irm https://dweller.games/install-cli.ps1 | iex
Sign in
dweller login # prints a URL + code; approve it in your browser
dweller login --token dg_xxx # or save a personal token
dweller whoami
In CI set DWELLER_TOKEN instead (create one at Settings → API tokens). DWELLER_API overrides the API base URL.
Commands
| Command | What it does |
|---|---|
dweller init [--title T] [--slug S] [--tagline …] [--tags a,b] [--engine …] |
Writes dweller.json in the current folder (and creates the game if it doesn't exist). |
dweller push [paths…] --version V [--notes …|--notes-file F] [--platform P] [--arch A] [--exec E] [--game slug] [--beta] [--draft] [--publish-game] |
Uploads builds and creates a release. With no paths it uses the builds list from dweller.json. Folders are zipped automatically. |
dweller games |
Lists your games. |
dweller create "Title" [--slug S] |
Creates a draft game. |
dweller update [--game slug] [--title …] [--tagline …] [--description-file README.md] [--tags …] [--status published|unlisted|draft] |
Edits the store page. |
dweller media header.png --kind header |
Uploads a header, cover or screenshot (--kind screenshot accepts many files). |
dweller open [slug] |
Prints the store URL. |
dweller version |
Prints the CLI version. |
Every command accepts --json for machine-readable output.
Examples
# Publish everything listed in dweller.json
dweller push --version 1.4.0 --notes-file CHANGELOG.md
# One-off: a web build folder and a Windows zip
dweller push build/web build/MyGame-windows.zip --version 1.4.1 --notes "Hotfix"
# Explicit platform for an ambiguous file name
dweller push dist/game.zip --platform linux --exec game.x86_64 --version 2.0.0
Platform detection from names: win/windows/.exe → Windows, mac/macos/darwin/.dmg → macOS, linux/.x86_64/.AppImage → Linux, web/html5 → Web, .apk → Android, .gba → GBA. Use --platform when a name has no hint.
View as Markdown (handy for feeding to an AI)