tangOS

# 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](https://github.com/tangosdev/tangOS/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`](schema/tangos.schema.json) - Reference example: [`sm64ds-decomp/tangos.json`](https://github.com/tangosdev/sm64ds-decomp/blob/main/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.