Map any codebase from your terminal

Surveyor walks a repository and draws it back to you as a tree, with sizes, churn, and history right in your shell. No browser, no account, no waiting.

$ brew install surveyor

macOS · Linux

Get started Changelog

surveyor — zsh

 ~/atlas   main  surveyor map ./app --depth 2

app/ 412 files ████████████ 100% ├── controllers/ 38 files █▏ 9% ├── models/ 51 files █▌ 12% ├── views/ 204 files ██████ 50% │ ├── pages/ 61 files █▊ 15% │ ├── posts/ 24 files ▊ 6% │ └── shared/ 119 files ███▌ 29% ├── javascript/ 87 files ██▌ 21% └── helpers/ 32 files ▉ 8% commits/wk ⣀⣀⣠⣤⣤⣴⣶⣾⣿⣷⣶⣦⣤⣠⣀ last 15 weeks ✓ mapped 412 files in 0.38s

Why Surveyor

Built for the terminal you already live in

Trees that line up: Box-drawing characters join cleanly, so nested folders read like a real map instead of a pile of pipes.
Charts in plain text: Block elements and Braille draw bars and sparklines that survive copy, paste, and a slow SSH session.
Your prompt, intact: Powerline symbols sit on the same cell as every other glyph, so prompts and status lines never jitter.

Benchmarks

Fast, even on the big ones

Cold runs on a laptop, mapping every file. Made-up numbers for a made-up tool, but the columns line up for real.

Repository	Files	Time	Relative
Small library	1,240	0.11 s	▍
Rails monolith	18,900	0.86 s	███▎
Monorepo	241,000	6.40 s	████████████████████████

Changelog

Shipping, one version at a time

v0.3.0

2026-09-28

Braille sparklines for commit history, plus a --since flag.
v0.2.0

2026-08-14

Depth limits, color themes, and a much faster file walker.
v0.1.0

2026-07-02

First release. It drew a tree and that was about it.