0.2.0-alpha - 2026-06-17

Warning

The pip wheels for this version did not publish — the macOS x86_64 build stalled on a deprecated CI runner, so there is no 0.2.0a0 on PyPI. Fixed in v0.2.1-alpha → use that for pip install --pre atlas-map. The binaries and curl | sh installer below are unaffected.

Release Notes

Second alpha. Headline: the symbol index more than doubles the comprehension
token win (−65.2% at 20/20 accuracy), and atlas now installs via pip/pipx
(pip install --pre atlas-map) alongside the existing curl | sh and cargo install.

Added

• pip / pipx distribution (pip install atlas-map). atlas now ships as a
  PyPI wheel so the Python-native audience (aider/Claude-Code/Cursor users) can
  install it without a Rust toolchain or a curl | sh, and reach it on Windows
  and in locked-down/corp environments where the shell installer doesn't work.
  The wheel wraps the same compiled binary via maturin bindings = "bin" (no
  Python runs at execution time; the atlas command lands on PATH); a new
  .github/workflows/pypi.yml builds the five platform wheels + an sdist
  fallback and publishes via PyPI Trusted Publishing (OIDC) on each release tag.
  Distribution name is atlas-map (bare atlas was taken); the command stays
  atlas. Additive — cargo-dist's curl | sh, archives, and cargo install
  are unchanged. Maintainer one-time setup before first publish: add the PyPI
  Trusted Publisher (project atlas-map, repo fkenmar/atlas, workflow
  pypi.yml, environment pypi).
• Symbol index for the collapsed tail (ADR 0004). When files overflow the
  budget, atlas now lists the names of the collapsed files' types — a compact
  path: ClassA, ClassB index — instead of erasing them into a bare directory
  skeleton, so an agent can locate the long tail without grepping. Type-first,
  ranked, capped per file; appears only when files collapse. The JSON output
  gains an additive symbol_index array (schema version unchanged). Benchmark
  delta: comprehension −65.2% tokens (85,670 → 29,781) at 20/20 accuracy
  in both arms, median turns 3 → 1, at the default 2,048 budget — more than
  doubling the prior −30.1% (run-20260617-084740).
• Prebuilt binary distribution via cargo-dist. A GitHub Actions release
  workflow (.github/workflows/release.yml) cross-builds atlas for macOS,
  Linux, and Windows (x86_64 + arm64) and publishes a curl | sh shell
  installer plus per-platform archives on every version tag. dist config lives
  in dist-workspace.toml.

Changed

• Leaner published crate. A Cargo.toml exclude drops dev-only process
  dirs (.claude, .github, benchmark, docs) and process docs from the
  packaged artifact: cargo package went from 81 to 41 files (55.8 KiB
  compressed) and still builds standalone.

Install atlas 0.2.0-alpha

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/fkenmar/atlas/releases/download/v0.2.0-alpha/atlas-installer.sh | sh

Download atlas 0.2.0-alpha

File	Platform	Checksum
atlas-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
atlas-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
atlas-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
atlas-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
atlas-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum