sysmap 0.2.0

Project Mapping CLI Tool
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# sysmap

A CLI tool that generates condensed, pattern-aware representations of project directories.

## What it does

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)
```

## Installation
```bash
cargo install sysmap
```

## Usage
```bash
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
```

## Supported Languages

Python, Rust, JavaScript, TypeScript, Go, Java, Ruby

Detects frameworks: Flask, Django, FastAPI, React, Vue, Next.js, Express, Actix, Rocket

## How it works

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/`

## License

MIT