codemap 🗺️

codemap — a project brain for your AI. Give LLMs instant architectural context without burning tokens.

Install

# macOS/Linux
brew tap JordanCoin/tap && brew install codemap

# Windows
scoop bucket add codemap https://github.com/JordanCoin/scoop-codemap
scoop install codemap

Other options: Releases | go install | Build from source

Quick Start

codemap .                    # Project tree
codemap --only swift .       # Just Swift files
codemap --exclude .xcassets,Fonts,.png .  # Hide assets
codemap --depth 2 .          # Limit depth
codemap --diff               # What changed vs main
codemap --deps .             # Dependency flow
codemap handoff .            # Save cross-agent handoff summary
codemap github.com/user/repo # Remote GitHub repo

Options

| Flag | Description | |------|-------------| | --depth, -d <n> | Limit tree depth (0 = unlimited) | | --only <exts> | Only show files with these extensions | | --exclude <patterns> | Exclude files matching patterns | | --diff | Show files changed vs main branch | | --ref <branch> | Branch to compare against (with --diff) | | --deps | Dependency flow mode | | | Check who imports a file | | | City skyline visualization | | | Animate the skyline (use with --skyline) | | | Output JSON |