CELL-LIST(1)                     Cell Manual                     CELL-LIST(1)

NAME
       cell list - List installed modules and their status

SYNOPSIS
       cell list

DESCRIPTION
       The list command displays all modules currently installed in your
       project, showing their aliases, locators, and status. It provides
       an overview of which modules are downloaded, vendored, compiled,
       or patched.

       The command reads the cell.toml file and checks the filesystem to
       determine the current state of each module.

OUTPUT FORMAT
       For each module, the command displays:
       - The alias used for importing
       - The full module locator with version
       - Download status in .cell/modules/
       - Vendoring status in modules/
       - Compilation status in .cell/build/
       - Applied patches

STATUS INDICATORS
       ✓ Downloaded     Module exists in .cell/modules/
       ✗ Not downloaded Module needs to be fetched with 'cell get'
       ✓ Vendored       Module copied to modules/ directory
       ✓ Compiled       Module bytecode exists in .cell/build/
       ✓ Patch exists   Patch file found for this module

EXAMPLES
       List all modules:
              cell list
       
       Example output:
              Installed modules:
              
              chess -> git.world/jj/chess@v1.0.0
                ✓ Downloaded to .cell/modules/chess@v1.0.0
                ✓ Vendored to modules/chess@v1.0.0
                ✓ Compiled to .cell/build/chess@v1.0.0
              
              engine -> git.world/jj/engine@v2.1.0
                ✓ Downloaded to .cell/modules/engine@v2.1.0
                ✗ Not vendored
                ✗ Not compiled
              
              Patches:
              chess -> ./patches/chess.patch
                ✓ Patch file exists

NOTES
       - The command only reads configuration, it doesn't modify anything
       - Invalid locators are marked but don't stop the listing
       - An empty dependencies section shows "No modules installed"

FILES
       .cell/cell.toml
              Read to get the list of dependencies
       
       .cell/modules/
              Checked for downloaded modules
       
       modules/
              Checked for vendored modules
       
       .cell/build/
              Checked for compiled modules
       
       .cell/patches/
              Checked for patch files

SEE ALSO
       cell(1), cell-get(1), cell-update(1), cell-vendor(1)