Ship your repo to your AI

Paleae snapshots your codebase into clean JSON/JSONL. Single file, zero dependencies, local-only processing.

Your codebase, optimized for AI understanding

Single file Zero dependencies Local-only MIT License AI-Ready LLM Context Python Tool JSON/JSONL Output v1.0.0 ~11KB

No install required

Download and run. It's that simple.

curl -fsSL https://raw.githubusercontent.com/PaulTiffany/paleae/main/paleae.py -o paleae.py && python3 paleae.py

Uses python3 to ensure a modern version of Python is used, as python may point to an older version on these systems.

curl -fsSL https://raw.githubusercontent.com/PaulTiffany/paleae/main/paleae.py -o paleae.py && python paleae.py

For Windows 10/11. Double-clickable paleae.py after download.

Invoke-WebRequest -Uri https://raw.githubusercontent.com/PaulTiffany/paleae/main/paleae.py -OutFile paleae.py; python paleae.py

Uses PowerShell's native Invoke-WebRequest command to download the file.

Built for trust

Every design decision prioritizes transparency and reliability

Single File Architecture

One file contains everything. No hidden dependencies, no package complexity. You can read every line of code and know exactly what it does.

Local-Only Processing

Your code never leaves your machine. No network calls during scanning, no telemetry, no data collection. Your repositories remain private.

Deterministic Output

Same input always produces identical output. File hashes verify integrity. Predictable behavior you can rely on in automated workflows.

Smart Filtering

Allows customizable .paleaeignore with glob patterns and negation (!). CLI accepts regex patterns for power users. Skip build artifacts, keep what matters.

AI-Optimized Format

Clean JSON/JSONL output with metadata, file hashes, and token estimates. Structured data that LLMs can parse and analyze effectively. Let your AI cook!

Sustainable Design

No feature creep, no breaking changes. Tools should solve problems, not create them.

The grain beneath the chaff

Paleae separates signal from noise in your codebase, like winnowing grain from chaff

Constraints breed clarity

Single file, zero dependencies. These aren't limitations—they're features that ensure simplicity and trustworthiness.

Local-first always

Your code contains your ideas and competitive advantages. It shouldn't require an internet connection to analyze.

Predictable by design

Surprises are bugs, not features. Deterministic output, clear error messages, consistent behavior.

Lean but powerful

Every feature must justify its existence. We resist bloat not from laziness, but from respect for the core mission.

Your Voice Matters

Found a bug, have an idea, or want to contribute? Your feedback shapes our evolution. Let us know on GitHub.

Report an Issue

Insta-Click Examples

Curious about `paleae`'s output? Download a JSON snapshot of the repository from our examples folder.

paleae.json