| Crates.io | sysmap |
| lib.rs | sysmap |
| version | 0.2.0 |
| created_at | 2025-12-29 02:40:51.483462+00 |
| updated_at | 2026-01-04 23:31:34.787265+00 |
| description | Project Mapping CLI Tool |
| homepage | |
| repository | https://github.com/DeclanFinerty/sysmap |
| max_upload_size | |
| id | 2009869 |
| size | 142,811 |
A CLI tool that generates condensed, pattern-aware representations of project directories.
Point sysmap at any project and get a compressed overview: directory structure, file purposes, line counts, and language detection - with common noise like node_modules/, .venv/, and target/ automatically collapsed.
$ sysmap summary
Project: flask-api
Type: Python (Flask)
Structure:
src/ 12 python files (1,847 lines)
tests/ 8 test files
Config: config.yaml, pyproject.toml
Key directories:
src/routes/ auth, users, products, health
src/models/ user, product, base
Collapsed:
.venv/ Python virtualenv (3,421 files)
cargo install sysmap
sysmap init # Build map of current directory
sysmap summary # Show condensed project overview
sysmap summary --json # Machine-readable output
sysmap summary --counts # Include token estimates
sysmap tree # Directory tree with annotations
sysmap tree -d 2 # Limit depth
sysmap tree --counts # Show chars/tokens per file
sysmap find <query> # Search for files
sysmap find user -t py # Filter by extension
sysmap find main --deps # Show dependencies for matches
sysmap deps <file> # Show file dependencies
sysmap deps <file> -r # Show what imports this file
sysmap update # Refresh map after changes
Python, Rust, JavaScript, TypeScript, Go, Java, Ruby
Detects frameworks: Flask, Django, FastAPI, React, Vue, Next.js, Express, Actix, Rocket
After sysmap init, a .sysmap/ directory stores the project map. The summary command generates a compressed view from this data.
Collapsed automatically: node_modules/, .venv/, __pycache__/, target/, .git/, dist/, build/
MIT