For developers

Thrungames CLI

Upload your game builds from your terminal or from CI, and manage your games, versions and upload tokens.

Shell

$ curl -fsSL https://cli.thrungames.com/install.sh | sh

Installs to ~/.local/bin after checking the download's SHA-256. Add -s -- --global after sh to install to /usr/local/bin instead.

Direct downloads

Prefer a binary? Pick your platform, unpack it and put thrungames on your PATH.

Verify a download against checksums.txt.

Get started

1
Step 1: Sign in
Opens your browser to approve the CLI.
```
$ thrungames login
```
2
Step 2: Upload a build
Zips the folder and saves it as a draft with a preview link.
```
$ thrungames upload dist
```
3
Step 3: Send it to review
Or pass --submit to upload to do both at once.
```
$ thrungames versions submit <id>
```

Optional: game.json

Put it at the root of your folder to skip the flags.

game.json

{
  "name": "space-dodger",
  "version": "1.4.0",
  "width": 960,
  "height": 600,
  "root": "dist"
}

game.json fields
Field	What it does
`name`	The game's slug or id; picks the game when you are logged in.
`version`	The version name. `--version` wins over it; run locally inside a git repository, the CLI falls back to `git describe`.
`width`, `height`	The game size, 1 to 4096 pixels.
`root`	The folder to zip, relative to `game.json`.

Upload from CI

Every push or tag can upload a build. CI has no git history to describe, so pass the version or set it in game.json.

Create an upload token for your game with thrungames tokens create <game> --name "GitHub Actions" (or on the game's page) and store it as a secret named THRUNGAMES_TOKEN. It can only upload builds for that one game.

.github/workflows/upload.yml

- uses: infobits-io/thrungames-upload-action@v1
  with:
    token: ${{ secrets.THRUNGAMES_TOKEN }}
    path: dist
    version: ${{ github.ref_name }}
    submit: ${{ startsWith(github.ref, 'refs/tags/') }}

Updates

The CLI tells you when a new version is out (or use brew upgrade thrungames). Set THRUNGAMES_NO_UPDATE_CHECK=1 to turn the notice off.

$ thrungames update

AI assistants

Every CLI command is also a tool on the thrungames MCP server, so an assistant can do the same things for you. For Claude Code:

$ claude mcp add --transport http thrungames https://mcp.thrungames.com