# gx: agent-first game analytics
> Add analytics to a game from your terminal: install the CLI, run gx init in the repo, draft the schema in the game's own words, verify, push. For agents: read start.md, then schema.md, then the game.

Every page is plain markdown. Read each one in full with a raw fetch (curl -s <url>); a fetch tool that summarizes drops the flags, field names and commands you need. Once the CLI is installed, gx docs <page> prints the same pages from the binary.

## Start
- https://gx.gccc.cat/start.md  the flow, what you need, step by step (read this first)
- Install: curl -fsSL https://gx.gccc.cat/install | sh   or on Windows: irm https://gx.gccc.cat/install.ps1 | iex   (or download https://gx.gccc.cat/dl/latest/<os>-<arch>/gx and check its sha256 against https://gx.gccc.cat/releases/latest)
- Set up a game: gx init in its repo (creates the project and the keys, vendors the SDK, installs the MCP server)
- Try it first: https://gx.gccc.cat/demo.md  (gx mcp install --demo for a live game with planted problems; gx init --demo for a sandbox game of your own)

## Reference
- https://gx.gccc.cat/schema.md  the schema file: properties, roles, the metric templates they enable, the onboarding questions
- https://gx.gccc.cat/cli.md  every command
- https://gx.gccc.cat/mcp.md  the MCP server and its tools
- https://gx.gccc.cat/privacy.md  what gx collects, consent in the SDK, the store data-safety forms (read before the first event is sent)
- https://gx.gccc.cat/sdk-dotnet.md  .NET (MonoGame, FNA, Stride)
- https://gx.gccc.cat/sdk-godot.md  Godot 4

## Service
- Ingest and query endpoint: https://ingest.gx.gccc.cat