Command Line Interface

Cell provides a command-line interface for managing packages, running scripts, and building applications.

Basic Usage

cell <command> [arguments]

Commands

cell version

Display the Cell version.

cell version
# 0.1.0

cell install

Install a package to the shop.

cell install gitea.pockle.world/john/prosperon
cell install /Users/john/local/mypackage  # local path

cell update

Update packages from remote sources.

cell update              # update all packages
cell update <package>    # update specific package

cell remove

Remove a package from the shop.

cell remove gitea.pockle.world/john/oldpackage

cell list

List installed packages.

cell list              # list all installed packages
cell list <package>    # list dependencies of a package

cell ls

List modules and actors in a package.

cell ls              # list files in current project
cell ls <package>    # list files in specified package

cell build

Build the current package.

cell build

cell test

Run tests.

cell test            # run tests in current package
cell test all        # run all tests
cell test <package>  # run tests in specific package

Manage local package links for development.

cell link add <canonical> <local_path>  # link a package
cell link list                          # show all links
cell link delete <canonical>            # remove a link
cell link clear                         # remove all links

cell fetch

Fetch package sources without extracting.

cell fetch <package>

cell upgrade

Upgrade the Cell installation itself.

cell upgrade

cell clean

Clean build artifacts.

cell clean

cell help

Display help information.

cell help
cell help <command>

Running Scripts

Any .ce file in the Cell core can be run as a command:

cell version    # runs version.ce
cell build      # runs build.ce
cell test       # runs test.ce

Package Locators

Packages are identified by locators:

  • Remote: gitea.pockle.world/user/repo
  • Local: /absolute/path/to/package
cell install gitea.pockle.world/john/prosperon
cell install /Users/john/work/mylib

Configuration

Cell stores its data in ~/.cell/:

~/.cell/
├── packages/       # installed packages
├── lib/            # compiled dynamic libraries
├── build/          # build cache
├── cache/          # downloaded archives
├── lock.toml       # installed package versions
└── link.toml       # local development links

Environment

Cell reads the HOME environment variable to locate the shop directory.

Exit Codes

  • 0 — Success
  • Non-zero — Error (check output for details)