# CARTO - Universal System File and Package Mapper

A command-line tool that provides comprehensive observability into your Linux system's package installations and file ownership. Providing a clear, tracable providence for every executable, and configuration file on your system.

## Installation

```bash
git clone <repository-url>
cd carto
cargo build --release
just install
```
## Usage

# Show package file tree
`carto tree --package bash`

`carto tree --package "Signal Desktop (org.signal.Signal)"`

# Package information
`carto package bash`

# File ownership

`carto file /usr/bin/bash`

# List packages
`carto packages`

`carto packages --source dnf`

`carto packages --source flatpak`

# Find files in package

`carto find --package bash`

## Example Output

```bash
bash 5.2.15-6.fc41
├── usr/
│   ├── bin/
│   │   └── bash
│   └── share/
│       └── man/
│           └── man1/
│               └── bash.1.gz
└── etc/
    └── skel/
        └── .bashrc

/usr/bin/bash is owned by package: bash

DNF packages (1,847 total):
  bash 5.2.15-6.fc41
  glibc 2.37-4.fc38

Flatpak packages (7 total):
  Signal Desktop (org.signal.Signal) 7.63.0
  GIMP (org.gimp.GIMP) 3.0.4
```