🦁 Laboros CLI Scanner

Verify your skills. Keep your code private. The official open-source verification tool for Laboros.ai.

🧐 What is this?

The Laboros Scanner is a "Dumb Collector." It is a local CLI tool designed to analyze your engineering patterns (complexity, consistency, architecture) without ever reading or uploading your actual source code.

We built this because we believe you shouldn't have to leak your employer's IP to prove you are a Top 1% engineer.

🛡️ Our Privacy Guarantee

1. Local Execution Only: This script runs 100% on your machine.
2. No Source Code Uploads: We strictly upload metadata (e.g., "Files changed: 50", "Language: Rust"). We never upload file contents.
3. Auditable: This repo is open source. You can read exactly what data we collect before you run it.

🚀 How it Works

1. Scans Git History: It looks at your commit timeline to verify consistency and ownership (proving you wrote the code).
2. Analyzes Complexity: It counts abstract patterns (loops, conditionals, architectural files) to determine the depth of your work.
3. Generates a Receipt: It creates a cryptographic "Merkle Root" of your repo state so we can verify the scan is authentic without seeing the code.
4. Outputs a Report: It generates a laboros-report.json file which you manually upload to your Laboros dashboard.

📦 Installation & Usage

You don't need to install anything permanently. You can run it directly using npx or bunx.

Prerequisites

• Node.js or Bun installed.
• Git installed.

Run the Scan

Navigate to the root of any project you want to verify:

cd my-private-project
npx laboros-scan
# or
bunx laboros-scan