CLI Reference

The lightrsi CLI provides shared commands for OpenClaw, Codex, Claude Code, pi, and OpenCode. DeepSeek Harness uses its native plugin interface and /tokenpilot-status.

Global Commands

Commands that work without specifying a host (uses the default host set by lightrsi use).

lightrsi report              # Latest session report across hosts
lightrsi visual              # Open visual inspector (shared, switchable)
lightrsi use <host>          # Set default host
lightrsi use <host> session <id>  # Pin default session
lightrsi context             # Show default host, pinned session, config
lightrsi --help              # Top-level help

OpenClaw Commands

In-Session (/lightrsi)

/lightrsi status             # Current plugin and runtime status
/lightrsi report             # Session token, cache, and cost report
/lightrsi doctor             # Full integration self-check
/lightrsi visual             # Open visual inspector
/lightrsi mode <mode>        # Switch: conservative | normal | aggressive
/lightrsi stabilizer target <developer|user>
/lightrsi reduction mode <light|balanced>
/lightrsi eviction <on|off>
/lightrsi settings details <on|off>
/lightrsi help               # List all commands

Standalone CLI

lightrsi openclaw status
lightrsi openclaw report
lightrsi openclaw doctor
lightrsi openclaw visual
lightrsi openclaw mode <mode>
lightrsi openclaw session <id> report
lightrsi openclaw stabilizer <on|off>
lightrsi openclaw stabilizer target <developer|user>
lightrsi openclaw reduction <on|off>
lightrsi openclaw reduction mode <light|balanced>
lightrsi openclaw reduction pass toolPayloadTrim <off>
lightrsi openclaw eviction <on|off>
lightrsi openclaw help

Codex Commands

lightrsi codex status
lightrsi codex report
lightrsi codex doctor
lightrsi codex visual
lightrsi codex session <id> report
lightrsi codex mode <conservative|normal>
lightrsi codex stabilizer <on|off>
lightrsi codex stabilizer target <developer|user>
lightrsi codex reduction <on|off>
lightrsi codex reduction mode <light|balanced>
lightrsi codex reduction pass toolPayloadTrim <off>
lightrsi codex reduction status
lightrsi codex help

Manual proxy control:

tokenpilot-codex status
tokenpilot-codex start

Claude Code Commands

lightrsi claude-code status
lightrsi claude-code report
lightrsi claude-code doctor
lightrsi claude-code visual
lightrsi claude-code session <id> report
lightrsi claude-code mode <conservative|normal>
lightrsi claude-code stabilizer <on|off>
lightrsi claude-code stabilizer target <developer|user>
lightrsi claude-code reduction <on|off>
lightrsi claude-code reduction mode <light|balanced>
lightrsi claude-code reduction pass toolPayloadTrim <off>
lightrsi claude-code reduction status
lightrsi claude-code help

pi Commands

lightrsi pi status
lightrsi pi report
lightrsi pi doctor
lightrsi pi visual
lightrsi pi session <id> report
lightrsi pi mode <conservative|normal>
lightrsi pi stabilizer <on|off>
lightrsi pi stabilizer target <developer|user>
lightrsi pi reduction <on|off>
lightrsi pi reduction mode <light|balanced|aggressive>
lightrsi pi reduction pass <name> <on|off>
lightrsi pi eviction <status|on|off>
lightrsi pi eviction set minBlockChars <number>
lightrsi pi help

OpenCode Commands

lightrsi opencode status
lightrsi opencode report
lightrsi opencode doctor
lightrsi opencode visual
lightrsi opencode session <id> report
lightrsi opencode mode <conservative|normal>
lightrsi opencode stabilizer <on|off>
lightrsi opencode reduction <on|off>
lightrsi opencode reduction pass <name> <on|off>
lightrsi opencode eviction <status|on|off>
lightrsi opencode eviction set minBlockChars <number>
lightrsi opencode help

DeepSeek Harness Commands

Inside a DeepSeek Harness session:

/tokenpilot-status

This read-only command reports estimator activity, eligible eviction work, scheduled or applied changes, and deferrals without creating a model turn. The adapter is registered by Cordis as tokenpilot-dsh; it does not use the shared lightrsi CLI.

See DeepSeek Harness for plugin installation and configuration. The global CLI commands above apply to OpenClaw, Codex, Claude Code, pi, and OpenCode.

Context Cleaner Commands

Cleaner is available through the shared CLI for openclaw, codex, and claude-code; it is not integrated in the pi and OpenCode adapters yet:

lightrsi <host> clean
lightrsi <host> clean --session <session-id>
lightrsi openclaw clean --require-tty --session <session-id>
lightrsi <host> clean --plan <plan-id> --select <task-id-1>,<task-id-2>
lightrsi <host> clean --status <plan-id>
lightrsi <host> clean --cancel <plan-id>

Analysis does not rewrite context. For OpenClaw, /lightrsi clean prints an exact-session --require-tty launcher when selectable tasks exist; run it from the shell that launched OpenClaw to open the selector without guessing a recent session. A non-TTY invocation prints the plan without approving it. The --plan ... --select ... command explicitly approves those task IDs. Status and cancellation do not rerun analysis, and cancellation cannot undo an applied clean.

Host	In-host entry	Apply timing
OpenClaw	/lightrsi clean; use its exact-session same-terminal launcher or the same plan/select/status/cancel options	Selection returns scheduled; the next ordinary request executes it
Codex	User-entered !lightrsi-clean terminal selector or installed lightrsi-clean MCP-form skill	Next eligible host request
Claude Code	Installed lightrsi-clean skill is analysis-only; approve with explicit plan and task IDs	Next eligible host request
DeepSeek Harness	Native /tokenpilot-clean with plan/select/status/cancel options; no shared CLI backend	Scheduled for the next ordinary agent request

For installation, interactive controls, protected tasks, and receipt meanings, see Context Cleaner.

Next

• Reports and Visuals — using the browser dashboard
• Logs and Diagnostics — finding and reading logs