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 / DeepSeek Harness / pi / OpenCode	See Host Compatibility for capabilities

Building LightRSI does not require API credentials. Host operation and optional model-based features have their own requirements. DeepSeek Harness requires a newer Node.js version and estimator credentials for eviction; follow its dedicated setup guide.

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 foundation and feature packages that plugins and adapters depend on.

Step 4: Build and Install the CLI

This step is for OpenClaw, Codex, Claude Code, pi, and OpenCode. For DeepSeek Harness, continue with native plugin installation and verify inside Harness using /tokenpilot-status; the shared CLI is not its installation or verification entrypoint.

pnpm lightrsi:build
pnpm lightrsi:install

The first command builds the shared lightrsi CLI. The second installs it to ~/.local/bin/lightrsi on Linux/macOS. For the complete Codex or Claude Code Cleaner flow, use pnpm cleaner:install:codex or pnpm cleaner:install:claude-code; those commands also build the recovery MCP, selected adapter, and explicit-only Cleaner analysis, status, apply, and cancel command skills. On Windows they create a lightrsi.cmd launcher.

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

For the shared CLI hosts:

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 OpenClaw, Codex, Claude Code, pi, and OpenCode
Shared packages	node_modules/ (workspace)	Runtime engine, types, contracts
Host adapter code	components/adapters/	Per-host integration code

Next

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