Install LightRSI

This page covers the LightRSI platform installation — the shared runtime that all plugins need. After this, install your first plugin (e.g., TokenPilot).

Prerequisites

Requirement	Minimum	Notes
Node.js	≥ 18	v20+ recommended
pnpm	≥ 9	v10.32+ used in development
OS	macOS, Linux, Windows (WSL)	Windows native may work but is less tested
Target Host	OpenClaw / Codex / Claude Code	At least one must be installed

No cloud services, API keys, or external dependencies are required.

Step 1: Clone the Repository

git clone https://github.com/zjunlp/LightRSI.git
cd LightRSI

Step 2: Enable Corepack and Install

corepack enable
pnpm install

This installs all workspace dependencies across the plugin packages and host adapters.

Step 3: Build Shared Packages

pnpm build

This builds the shared packages (runtime-core, kernel, layers, host-adapter) that all plugins and adapters depend on.

Step 4: Build and Install the CLI

pnpm lightrsi:build
pnpm lightrsi:install

The first command builds the shared lightrsi CLI. The second installs it to ~/.local/bin/lightrsi.

PATH notice Make sure ~/.local/bin is on your PATH. Add this to your shell config if needed:

export PATH="$HOME/.local/bin:$PATH"

Verify Installation

lightrsi --help

You should see the top-level command listing.

lightrsi context

This shows your current default host, pinned session, and config target.

What Got Installed

Component	Location	Purpose
lightrsi CLI	~/.local/bin/lightrsi	Standalone CLI for all hosts
Shared packages	node_modules/ (workspace)	Runtime engine, types, contracts
Host adapter code	components/tokenpilot/adapters/	Per-host integration code

Next

• Install Your First Plugin — install TokenPilot for your host
• Quick Start — end-to-end walkthrough