Cell 0 OS — npm Global Install

OpenClaw-style npm installation for Cell 0 OS — the Sovereign Edge Operating System.

Quick Start

# Install Node.js >= 22, then:
npm install -g cell0-os@latest

# Onboard and install daemon (macOS launchd / Linux systemd)
cell0 onboard --install-daemon

# Or run gateway in foreground
cell0 gateway --port 18800 --verbose

Commands

| Command | Description | |---------|-------------| | cell0 onboard [--install-daemon] | Run onboarding wizard | | cell0 gateway [--port 18800] | Run gateway in foreground | | cell0 status | Check system status | | cell0 start | Start Cell 0 daemon | | cell0 stop | Stop Cell 0 daemon | | cell0 configure | Run configuration wizard | | cell0 doctor | Diagnose system issues | | cell0 logs [--follow] | View system logs | | cell0 daemon <install\|uninstall\|status\|restart> | Manage background daemon | | cell0 message send --message "..." | Send a message | | cell0 agent --message "..." | Talk to the assistant | | cell0 chat | Start interactive chat |

How It Works

1. The cell0 npm binary checks if Cell 0 is installed
2. If not, it downloads and runs https://kulluai.com/install.sh
3. Then it delegates all commands to the Python-based cell0ctl CLI

Requirements

• Node.js: >= 22 (for the npm wrapper)
• Python: >= 3.10 (for Cell 0 runtime)
• Git: For cloning the repository
• bash: For running the installer

Platform Support

• macOS: Uses launchd for daemon management
• Linux: Uses systemd --user for daemon management

First Run

On first execution, Cell 0 will:

1. Clone the repository to ~/cell0
2. Create a Python virtual environment at ~/.cell0/venv
3. Install all dependencies
4. Run the configuration wizard

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | CELL0_HOME | Installation directory | ~/cell0 | | CELL0_STATE_DIR | State/config directory | ~/.cell0 | | CELL0_VENV | Python virtualenv path | ~/.cell0/venv | | CELL0_BIN_DIR | CLI binary location | ~/.local/bin |

Development

# Clone the repo
git clone https://github.com/YigremTamiru/cell0-os.git
cd cell0-os

# Link for local development
npm link

# Now you can test 'cell0' command locally
cell0 status

License

GPL-3.0-only