Skip to content

Runtime Modes

TokenPilot provides three runtime modes: conservative, normal, and aggressive. Each is a preset that configures the stabilizer, reduction, and eviction subsystems. Switch modes at any time without restarting.

Mode Comparison

BehaviorConservativeNormalAggressive
Stable PrefixOnOnOn
Stabilizer targetDeveloperDeveloperUser
ReductionLightBalancedStrong
Reduction trigger4000 chars2200 chars1400 chars
Max tool chars18001200900
EvictionOffOffOn
Risk of signal lossVery lowLowModerate
Token savingsModerateHighMaximum

Conservative Mode

For safety-critical sessions where you cannot afford to lose any context.

bash
lightrsi mode conservative
  • Stabilizer rewrites context into cache-stable form but keeps it developer-visible
  • Reduction applies light trimming only — removes truly redundant output
  • Eviction is disabled — full history is always available

Normal Mode

The default and recommended mode for most sessions.

bash
lightrsi mode normal
  • Stabilizer rewrites context and attaches dynamic content at the developer level
  • Reduction applies balanced trimming — removes noise while keeping signal
  • Eviction is disabled by default — for most sessions, reduction alone is sufficient

Aggressive Mode

For maximum savings when you're willing to trade some context completeness.

bash
lightrsi mode aggressive
  • Stabilizer rewrites context and attaches dynamic content at the user level (further from the model)
  • Reduction applies strong trimming — may discard borderline-useful output
  • Eviction is enabled with lower thresholds — older context is dropped sooner

Switching Modes Mid-Session

You can change modes at any time — no restart needed:

bash
# Per-host (OpenClaw supports all three modes)
lightrsi openclaw mode aggressive

# Codex and Claude Code only support conservative and normal
lightrsi codex mode conservative
lightrsi codex mode normal
lightrsi claude-code mode conservative
lightrsi claude-code mode normal

# Or inside OpenClaw session
/lightrsi mode aggressive

The new mode takes effect on the next turn.

Next

Released under the MIT License.