# paazmaya/shuji

Reverse engineering JavaScript and CSS sources from sourcemaps

Repository: https://github.com/paazmaya/shuji
Canonical: https://ross.abutalabs.com/products/shuji
Language: JavaScript
License: MIT
License Family: permissive
Topics: hacktoberfest, nodejs, sourcemaps
Last push: 2026-08-25T22:36:16+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 3856, "days_push": 8, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1241, forks 189 (observed 2026-08-28T04:04:06.441849+00:00)

## What it is
Shuji is a Node.js command line utility that reconstructs original JavaScript and CSS source files from sourcemap files (.map), including inline sourcemaps. It can process single files or directories and optionally preserve the original folder structure.

## Use cases
- recover original source code from a .js.map sourcemap file
- extract sources from inline sourcemaps in minified JavaScript
- restore original CSS from a compiled sass sourcemap
- batch convert a directory of sourcemap files back to sources
- debug minified production code by regenerating readable sources

## When to choose
- you have sourcemap files but lost the original sources
- you need to inspect minified production JavaScript or CSS
- you want a simple CLI that handles both file and inline sourcemaps

## When to avoid
- you need to generate sourcemaps rather than reverse them
- you work outside the Node.js ecosystem
- sourcemaps lack embedded sources content, since recovery depends on what the map contains

## Facets
- artifact type: cli-tool
- maturity: active
- function: reverse-engineering, parser, developer-tools, cli
- domain: developer-tools, web-development, files
- platform: cli, cross-platform
- tags: sourcemaps, javascript, css, minified-code, source-recovery, nodejs

## Member repositories
- paazmaya/shuji (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:06.441849+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:08:30.055016+00:00, confidence not recorded.
  - readme: https://github.com/paazmaya/shuji (fetched 2026-08-28T04:04:06.441849+00:00, sha 1e56a4c5b468)
  - registry_npm: https://registry.npmjs.org/shuji (fetched 2026-08-29T12:20:26.783921+00:00, sha 9298b9fa9930)
- Data as of 2026-08-30T08:39:29.467469+00:00.