tangOS

A unified brand and toolkit for reverse-engineering / decompilation projects.

Everything reads one file per repo - tangos.json - a descriptor that normalizes any decomp repo (whatever its layout) into a single vocabulary. Point a tangOS app at a repo, and it knows the repo's tools, compiler, data source, and rules.

Apps

App	What it is	Status
tangOS Console	Downloadable desktop app. Exposes a repo's tools as an MCP server an AI connects to, with a live viewer to watch the AI drive them in real time.	in progress (console/)
tangOS Docs	Browsable catalog of a repo's tools, generated from tangos.json.	planned (docs/)
tangOS Atlas	Progress atlas / treemap (formerly Chaos Viewer).	planned rebrand

Download

tangOS Console ships as a desktop app that auto-updates from this repo's Releases.

• Windows - download and run the installer; it self-updates from here. Not code-signed yet, so Windows warns once: click More info, then Run anyway.
• macOS - download the .dmg (Intel or Apple Silicon). Unsigned, so right-click the app and choose Open (or run xattr -cr "/Applications/tangOS Console.app").

The descriptor: tangos.json

• Schema: schema/tangos.schema.json
• Reference example: sm64ds-decomp/tangos.json
• A repo that has no tangos.json yet gets one generated by Console (heuristic scan + optional AI refine).

The descriptor declares a tools[] registry; Console turns each entry into an MCP tool generically, so tangOS itself stays repo-agnostic while your repo's own tools do the work.

Layout

tangOS/
├── schema/            tangos.json JSON schema
├── packages/ui/       shared aero theme tokens + glass components
├── console/           the Electron Console app (MCP + live viewer)
└── docs/              the tool catalog site (planned)

Develop

npm install            # from the repo root (workspaces)
npm run console        # start Console in dev (electron-vite)

Built with Claude Code.