Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tombstack CLI tools (Node 18+, no deps)

  • uploader/upload.mjs — drain a directory of crash JSON sidecars to the ingestion endpoint (offline-first; for native/custom engines). Auth: a per-game ingest token (tmb_…).
  • symbols/symbols.mjs — upload a single build symbol file (PDB/dSYM/.sym) to the symbol store from CI, with an explicit debugId. Auth: a studio key (tmb_st_…, write scope) + TOMBSTACK_GAME_ID — per-game tokens are ingest-only and can't upload symbols.
  • symbols/symbols-zip.mjs — upload a whole symbols archive (Unity/Android symbols.zip); the server unzips it and extracts every module + debugId itself (no per-file metadata). Same studio-key + TOMBSTACK_GAME_ID auth. Use this for Android IL2CPP builds.
  • doctor/doctor.mjs — post a synthetic crash + heartbeat, then read it back, to confirm an integration end to end. Auth: a per-game ingest token (tmb_…) for the two ingest steps. The read-back step needs a credential that can read — a studio key (tmb_st_…) plus TOMBSTACK_GAME_ID, or a per-game token explicitly granted the read scope — supplied as TOMBSTACK_READ_TOKEN. Without it that one step is reported as skipped, not failed: ingest-only is the default for a per-game token, so its 403 says nothing about the integration.

All read TOMBSTACK_BASE_URL + TOMBSTACK_TOKEN from the env; symbols also reads TOMBSTACK_GAME_ID; doctor optionally reads TOMBSTACK_READ_TOKEN (+ TOMBSTACK_GAME_ID when that is a studio key).

Run directly with node (they have zero dependencies), e.g.:

TOMBSTACK_BASE_URL=https://<host> TOMBSTACK_TOKEN=tmb_st_… TOMBSTACK_GAME_ID=<gameId> \
  node symbols/symbols.mjs GameAssembly.sym 1.5.0 GameAssembly.dll <debugId> windows

Published to the public AnkleBreaker-Studio/tombstack-cli mirror (synced from this dir via scripts/publish-cli-repo.ps1), so CI can run the bin names with zero setup — no checkout, no npm install:

npx --yes --package github:AnkleBreaker-Studio/tombstack-cli tombstack-symbols <file> <build> <module> <debugId> [os]

Pin a release with github:AnkleBreaker-Studio/tombstack-cli#v0.2.1.

About

CLI tools for Tombstack — CI symbol upload + offline crash upload (zero-dep, Node 18+)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages