Overview

See through your codebase before it breaks

ARCLUX

See through your codebase before it breaks. Every codebase accumulates debt nobody can see until it’s too late — circular dependencies, dead code, files nobody remembers touching. ARCLUX builds a live dependency graph of your repo, traces the blast radius of every change, and catches structural rot before it ships.

Get started

Not yet published to npm — clone and build locally.

git clone https://github.com/GSF-001/ARCLUX.git
cd ARCLUX
pnpm install

Run CLI commands via:

npx tsx apps/cli/index.ts analyze [path]

Or start the web dashboard:

cd apps/web
pnpm run dev

Jalan di Termux (Android) arm64: apps/web pakai Webpack, bukan Turbopack — Turbopack belum didukung di arsitektur ini. Jangan tambahkan --turbo ke script dev.

Parsing TypeScript/TSX pakai TypeScript Compiler API, parsing Python pakai web-tree-sitter. Kalau nambah bahasa baru, cek packages/parser/ dulu sebelum bikin parser baru.

What it actually does

Dependency graph

Maps every import, export, and folder into one live dependency graph

Impact analysis

Change one file, trace everything downstream before you ship

20 structural detectors

Circular deps, dead code, orphan files, layer violations, and more

Framework conventions

Enforces conventions across Next.js, NestJS, Express, Vite, Electron, React, Laravel

Scripting DSL

arclux script — chain analyze, impact, doctor, security in plain-text scripts

Status: alpha

This project is under active development with a small team. Expect breaking changes and stubs that aren’t wired up yet.

Solid today

Core pipeline, 27 languages, all 20 detectors, impact analysis, DSL, search, security — verified against vscode, react, vite, laravel, flask

Not there yet

Persistence layer (packages/db), per-file incremental re-indexing, npm publishing

Next steps

Usage

Full CLI command reference and web dashboard setup

Architecture

How the pipeline fits together: parser to graph to detectors

Status & Progress

What’s solid, what’s a stub, and what’s actively being worked on

Codebase Map

Browse every package and app in the monorepo