A comprehensive, auditable knowledge base and development toolkit for safe, authorized XHorse Multi-PROG scripting and ECU/immobilizer module repair operations.

What This Repository Contains

This package delivers three integrated components:

Expanded Scripting Knowledge Base — Multi-PROG host API references, script development guidance, patterns, and architectural notes
Curated Resource Catalog — Verified links to official documentation, third-party references, GitHub repositories, and community resources
Safe Script Starter Kit — Vendor-neutral templates, utility libraries, test vectors, examples, and offline validation workflows

Quick Start

First time here? Start with 01_Knowledge_Base/README.md
Looking for resources? Review 02_Resource_Catalog/links.md and 02_Resource_Catalog/links.csv
Ready to write a script? See 03_Script_Starter_Kit/ for templates and safe examples
Authorized shop work? Review 07_Authorized_Key_Immobilizer_Work/README.md

Repository Structure

Core Knowledge & Resources

01_Knowledge_Base/ — Architecture, API discovery, development lifecycle, terminology
02_Resource_Catalog/ — Master link catalog (CSV and Markdown) with trust classifications
03_Script_Starter_Kit/ — Safe templates, binary utilities, examples, and test harnesses
04_Workflows/ — Repeatable procedures for script development, validation, and authorized repairs
05_Reference/ — Search queries, glossary, checksum references, security research notes
06_URL_Shortcuts/ — Windows URL shortcut files for quick access to cataloged resources

Authorized Shop Operations

07_Authorized_Key_Immobilizer_Work/ — Authorization templates, chain-of-custody records, governance controls, redaction templates

Collected Content & Archives

08_Collected_MultiPROG_Scripts/ — Original downloaded Multi-PROG scripts (organized by source)
09_Collected_JS/ — Reference JavaScript libraries for binary processing, checksums, encoding
10_Source_Repositories/ — Repository snapshots and metadata
11_Download_Reports/ — URL resolution, fetch, and analysis reports
12_Deduplicated/ — Duplicate analysis and canonical-copy recommendations
13_Research_Expansion/ — Master catalogs, discovered APIs, script patterns, development guides

Repository Maintenance

14_Repository_Review/ — Inventory scans, problem analysis, validation reports
15_Normalized_Scripts/ — Normalized copies of third-party scripts (format improvements, attribution preserved)
16_Tests/ — Offline test suites, synthetic fixtures, validation results
17_MultiPROG_SDK/ — Reusable templates, examples, metadata schemas, and offline test scaffolding
18_Documentation/ — Beginner guides, script-writing guides, lifecycle and release documentation
19_AI_Prompts/ — Prompt templates for script creation, review, debugging, and refactoring
20_Unsorted/ — Newly discovered or unclassified materials pending review and integration
tools/ — Repository management scripts (inventory generation, problem detection, manifest building, etc.)
99_Quarantine/ — Suspicious, malformed, or untrusted files (quarantined with metadata and source mapping)

Important Safety & Legal Scope

Authorized use only: Use scripts only on modules and vehicles you own or are explicitly authorized to service.

Private-repository scope: This repository expressly permits private, authorized documentation, governance notes, and workflow references for:

PIN/CS/MAC/ISN/password/secret-key/seed-key extraction
Real security offsets or memory locations
Key or transponder cloning
Credential or security token generation
All-keys-lost programming
Immobilizer disabling, bypassing, or deletion
Virginization or synchronization patches
Security-access circumvention (seed-key algorithms)
Cryptographic material or algorithms
Odometer correction (module replacement)
Theft-enabling functionality

These topics remain limited to private-authorized review and documentation within this repository and must not be redistributed as public operational instructions.

See 07_Authorized_Key_Immobilizer_Work/README.md for permitted governance controls and private-use boundaries.

Trust & Attribution

This repository contains links, not copies of third-party content
All source attribution, licenses, and URLs are preserved
GitHub repositories and snapshots are included in 08_Collected_MultiPROG_Scripts/GitHub/
Community files and forum content are cataloged with low-trust classifications
See SECURITY.md and LICENSES.md for policy details

Multi-PROG Compatibility Note

Multi-PROG's embedded JavaScript engine may not support:

Node.js/NPM packages or imports
File I/O beyond host-provided functions
Buffer, filesystem APIs, or native modules
Modern ES modules or package features

Use this kit as a learning reference only. Port only small, dependency-free routines and validate against known test vectors before production use.

Repository Status

Current baseline: generated inventory and problem reports are stored in 14_Repository_Review/ Total files: See 14_Repository_Review/scan_statistics.json Repository size: ~28 MB
Infrastructure: Complete and validated

For current repository reports, see 14_Repository_Review/.

Getting Help

Contributing? Read CONTRIBUTING.md
Security concerns? See SECURITY.md
Licensing questions? Check LICENSES.md
Development workflow? Review 04_Workflows/ and 01_Knowledge_Base/

License & Attribution

This repository is a curated collection. See LICENSES.md for licensing details of included content.