šŗļø docmap
> docmap ā instant documentation structure for LLMs and humans.
> Navigate massive docs without burning tokens.

The Problem
Documentation files are everywhere ā READMEs, design docs, changelogs, API references, PDFs. But:
- LLMs can't open large markdown files or PDFs (token limits)
- Humans have to open each file to see what's inside
- There's no "file tree" for documentation content
The Solution
docmap .
āāāāāāāāāāāāāāāāāāāāāāāā docs/ āāāāāāāāāāāāāāāāāāāāāāāā®
ā 22 files | 645 sections | ~109.2k tokens ā
ā°āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāÆ
āāā README.md (3.8k)
ā āā Project Overview
ā āā Installation
ā āā Quick Start
āāā docs/ARCHITECTURE.md (7.7k)
ā āā System Design
ā āā Component Details
ā āā Data Flow
āāā docs/API.md (12.1k)
ā āā Authentication
ā āā Endpoints
ā āā Error Handling
āāā CHANGELOG.md (15.2k)
āā v2.0.0
āā v1.5.0
āā v1.0.0
One command. Instant structure. No LLM needed.
Install
# macOS/Linux
brew tap JordanCoin/tap && brew install docmap
# Windows
scoop bucket add docmap https://github.com/JordanCoin/scoop-docmap
scoop install docmap
> Other options: Releases | go install github.com/JordanCoin/docmap@latest
Usage
docmap . # All markdown and PDF files in directory
docmap README.md # Single markdown file deep dive
docmap report.pdf # Single PDF file structure
docmap docs/ # Specific folder
docmap README.md --section "API" # Filter to section
docmap README.md --expand "API" # Show section content
docmap . --refs # Show cross-references between docs
Output
Directory Mode
Map all markdown and PDF files in a project:
docmap /path/to/project
Shows each file with token count and top-level sections.
Single File Mode
Deep dive into one document:
docmap docs/ARCHITECTURE.md
āāāāāāāāāāāāāāāāāāā ARCHITECTURE.md āāāāāāāāāāāāāāāāāāā®
ā 33 sections | ~7.7k tokens ā
ā°āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāÆ
āāā System Design (2.1k)
ā āāā Vision
ā āāā Core Principles
ā ā āā "Headless-first", "Plan before execute"
ā āāā Architecture Overview
āāā Components (3.2k)
ā āāā Scheduler
ā āāā Orchestrator
ā āāā Memory (RAG)
āāā Security (1.4k)
āā "SSH keys only", "Human gates"