Nexus Studio

Desktop IDE + portable /v1 model for Stake Engine slot development

Math · Frontend · Social · Approval · RGS · Pixi · Tile · Slot Engine (TS math) — one private studio.

Download Agent · Features · Slot Engine · Model API · Approval · Quick start

---

Download Nexus Agent

Nexus Agent is the product — free in Chat, portable via /v1, and bundled in the desktop studio.

Download the Agent pack (file)

Direct file: nexus-agent-0.1.1.zip

Includes:

• Tiny local /v1 stub (start-agent.cmd / start-agent.sh) — works without hunting for dev:backend
• Pack catalog version stamped on responses (x-nexus-pack-version)
• Nexus MCP server (mcp/index.mjs) — BookEvent, social lint, Slot Engine math-stack tools
• Cursor .cursor/mcp.json + workspace rules (tool-first /sim, publish-strict, file-anchored)
• OpenAI-compatible Cursor settings snippet (cursor-openai-compatible.json)
• Claude Desktop MCP example + model alias list

Unzip → run start-agent.cmd (or ./start-agent.sh) → point Cursor at http://127.0.0.1:4000/v1 → model nexus-agent-casino or nexus-agent-slot-engine.

| Base URL hosted `/v1` (preferred) or `http://127.0.0.1:4000/v1` (local only)
API key nxk_… or dev-nexus-local
Model nexus-agent-casino # Stake FE + math + social
# or nexus-agent-slot-engine # @slot-engine/core TS math
# Note: 127.0.0.1 is this machine — not your public IP

Desktop studio installers (when published)

Full IDE installers attach to the same GitHub Release:

Platform	Architecture	Install
Windows	x64	Latest .exe / .msi
macOS	Apple Silicon / Intel	Latest .dmg
Linux	x64	Latest .AppImage / .deb

Auto-update: Desktop builds check this repo's release feed when signing/updater config is enabled.

---

Features

Desktop studio

• Monaco editor + workspace indexer + Problems rail (Books explorer + Math ↔ FE contract board)
• AI chat with suggest & approve changesets (hunk-level Accept / Reject)
• Task playbooks (BookEvent drift, RTP balance, social pass, preflight) — one click sets seat + model + panel
• Studio health score on Home (BookEvent · social · math stack · LUT)
• New game wizard + mechanic kits (tumble / ways / hold-and-spin / cluster / Slot Engine)
• Publish dry-run checklist before stakecli; reject-memory coach on Problems
• Chat slash recipes: /bookevent /social /rgs /tile /replay /pixi /audio /math /publish /feel /locale /mechanic /sim
• Sim result cards + cite-or-tool badges; example landed-diff few-shots
• 13 context packs including slot-engine (web-sdk, math, math-deep, social, approval, RGS, tile, Pixi, audio, mechanics, XState, telemetry, slot-engine)
• 12 agent presets (blockers · social · paytable · game-feel · RGS · Spine/FX · bonus-buy · max-win · locale · Storybook · perf · publish scope)
• Studio seat setting (math / FE / art / compliance / audio / producer) for default packs + knowledge domains
• GitHub clone / commit / PR from the IDE
• Local + cloud analytics (Pro+)

Stake approval tooling

• One-click preflight — F1–F7 gates + checkgame blockers (Approval panel)
• 17-viewport responsive QA with shot folder (.nexus/responsive-qa/shots)
• Live BookEvent drift diagnostics in the Problems rail
• Inline social-term linter for sweeps_* locales (Monaco markers)
• Publish wizard — scope → gates → build → checkgame → consent → stakecli (restart-on-fail)
• One-click MCP install for Cursor and Claude Desktop

Slot Engine (TS math)

First-class support for community @slot-engine/* (Stake-compatible books/LUTs — not affiliated with Stake):

Capability	What it does
Detect	@slot-engine/core in package.json → TS math detected, auto math seat + game root
Run sim	npx tsx ./index.ts --slot-engine-run from Approval
Optimize	@slot-engine/optimizer / doOptimization + RTP / hit-rate summary
Publish gate	Fresh sim + LUT↔book id alignment before math publish
Math Lab	Launch @slot-engine/panel (stats, reels_*, books explorer)
Scaffold	New lines / cluster game with rootDir, sim config, .cursor / .nexus rules
Hard rule	Never mix Python Math SDK books with Slot Engine books in one publish

Prefer model nexus-agent-slot-engine (packs: slot-engine + math-deep + mechanics + approval). Chat: /sim.

Studio dashboard

• Playbook — 20 casino-dev checklist items
• Approval — per-title ship readiness gates
• Analytics — desktop assists + /v1 completions
• Team — math / FE / art / compliance seats
• Billing — seat vs token clarity
• Model page — profiles, prompts, mechanic kits, review-bounce playbook

Portable model (/v1)

• OpenAI-compatible GET /v1/models, POST /v1/chat/completions
• Bearer nxk_… API keys or dev key
• Model aliases with pack injection:

Model	Injects
nexus-agent	General (no casino packs)
nexus-agent-casino	web-sdk + math + social + approval (recommended for FE)
nexus-agent-math	math + math-deep
nexus-agent-rgs	RGS wallet + web-sdk + XState
nexus-agent-math-deep	math + math-deep + mechanics
nexus-agent-tile	game tile + approval
nexus-agent-pixi	Pixi runtime + web-sdk + XState
nexus-agent-audio	Howler audio + web-sdk
nexus-agent-compliance	social + approval
nexus-agent-slot-engine	slot-engine + math-deep + mechanics + approval (TS math)

Aliases also accepted: nexus-casino, nexus-rgs, nexus-ts-math, …

• Cursor · ChatGPT Actions · Claude MCP (hint + runnable tools)

MCP tools

Hints: playbook · approval gates · social terms · BookEvent hint · publish preflight · viewports · paytable · review-bounce · model profiles · seat map

Runnable: run_bookevent_check · lint_social_file · list_betmodes · explain_book_event · rgs_request_sketch · detect_math_stack · run_slot_sim · run_optimize · inspect_lut_rtp · mechanic starter kits

---

Quick start

Agent pack (recommended today)

1. Download nexus-agent-0.1.1.zip
2. Unzip and follow the pack README.md (Cursor OpenAI Compatible + MCP).
3. Start backend /v1 (npm run dev:backend from the private monorepo, or your hosted endpoint).
4. Use model nexus-agent-casino or nexus-agent-slot-engine.

Desktop installer

1. Open Releases when OS installers are attached.
2. Open Nexus on a Stake math + web-sdk (or @slot-engine) workspace.
3. Set Settings → Stake game root (Slot Engine trees auto-detect).
4. Open Approval for preflight / Slot Engine sim / publish / MCP install.

From source (private monorepo)

git clone <your-private-monorepo-url>
cd nexus-workspace
npm install
npm run build -w @nexus/shared
npm run build -w @nexus/model-adapters
npm run check:bookevent
npm run check:responsive
npm run dev # desktop (Tauri default)
npm run dev:backend # API + /v1 on :4000
npm run mcp
npm run dev -w @nexus/web

---

Portable model (/v1)

GET http://127.0.0.1:4000/v1/models
POST http://127.0.0.1:4000/v1/chat/completions
Authorization: Bearer <NEXUS_AGENT_CLIENT_KEY or nxk_…>

Cursor → Settings → Models → OpenAI Compatible:

Base URL http://127.0.0.1:4000/v1
API key nxk_… or dev-nexus-local
Model nexus-agent-casino # FE / social / approval
# or nexus-agent-slot-engine # @slot-engine/core

Health: GET http://127.0.0.1:4000/health

Chat slash recipes (desktop)

/bookevent
/social focus on overlays
/rgs
/tile
/math
/sim # Slot Engine TS math
/publish
/mechanic

---

Studio roles

Nexus does not sell subscription seats. Sign in for team invites, approval, and analytics; bring your own model provider keys (Ollama / OpenAI / etc.).

Desktop Settings → Studio seat maps role → default context packs (math includes slot-engine).

---

Architecture

┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Nexus Desktop │────▶│ Backend :4000 │◀────│ Cursor / Actions│
│ (Tauri/Electron)│ │ /v1 · auth · team│ │ OpenAI-compat │
└────────┬────────┘ └────────┬─────────┘ └─────────────────┘
 │ │
 │ ┌────────▼─────────┐
 └─────────────▶│ Studio dashboard │
 │ playbook·approval│
 └──────────────────┘

Approval: preflight F1–F7 · Slot Engine sim/optimize/Math Lab/scaffold · responsive QA · publish wizard · MCP Problems: BookEvent drift · social-term · books explorer · math-stack / LUT alignment Changes: hunk-level Accept / Reject

---

Ship checklist (abbreviated)

1. Scaffold from Stake UI template — don't reinvent the shell
2. RGS / auth / URL params — money as micro-units
3. BookEvent types match math output (check:bookevent / Problems rail)
4. XState owns lifecycle; GSAP/Pixi animate only
5. Social mode + sweeps_* locales (inline linter)
6. Replay + active-round recovery
7. Responsive QA across 17 viewports
8. One-click preflight clear → owner-consented publish wizard
9. If Slot Engine: detect stack → sim → optimize → LUT↔book gate → never mix Python Math SDK books

Full docs ship with the dashboard at /docs.

---

Releases / changelog highlights

Area	What's new
Download	nexus-agent-0.1.1.zip direct download (MCP + Cursor rules + /v1 snippets)
Approval	F1–F7 preflight, checkgame, publish wizard, responsive QA, Slot Engine sim/optimize/Math Lab/scaffold
Review	Hunk-level Accept/Reject, Problems rail + books explorer
Model	10 /v1 aliases (incl. nexus-agent-slot-engine), 13 packs, 12 presets, slash recipes (/sim), seat packs
MCP	BookEvent / social / betmode / RGS + detect_math_stack · run_slot_sim · run_optimize · inspect_lut_rtp

Tag	Notes
v0.1.1	Latest Agent zip (nexus-agent-0.1.1.zip) — Slot Engine one-shot math rules
v0.1.0	Initial Agent zip; desktop installers when CI publishes

Release runbook (maintainers): bump version → tag vX.Y.Z → upload Agent zip + Windows/macOS/Linux artifacts.

---

License

Proprietary — contact for commercial / studio licensing. Source is not public in this repository; this repo distributes release artifacts and studio documentation.

---

Download Nexus Agent (.zip) · Releases · Profile @g8tsz · Slot Engine

Stake Engine · slot studio tooling · not affiliated with Stake.com · Slot Engine is a community project