Files
cell/scripts/man/list.man

77 lines
2.4 KiB
Groff

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)