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.

Host Availability

Host	Configuration
OpenClaw	conservative, normal, aggressive
Codex	conservative, normal
Claude Code	conservative, normal
DeepSeek Harness	Configure tokenpilot-dsh in the Harness profile; the shared runtime-mode commands do not apply
pi	conservative, normal
OpenCode	conservative, normal

For DeepSeek Harness, follow Configure and Enable. Its opt-in eviction is controlled by profile settings, not by choosing aggressive mode.

Mode Comparison

Behavior	Conservative	Normal	Aggressive
Stable Prefix	On	On	On
Stabilizer target	Developer	Developer	User
Reduction	Light	Balanced	Strong
Reduction trigger	4000 chars	2200 chars	1400 chars
Max tool chars	1800	1200	900
Eviction	Off	Off	On
Risk of signal loss	Very low	Low	Moderate
Token savings	Moderate	High	Maximum

Conservative Mode

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

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.

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.

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:

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

# Codex, Claude Code, pi, and OpenCode only support conservative and normal
lightrsi codex mode conservative
lightrsi codex mode normal
lightrsi claude-code mode conservative
lightrsi claude-code mode normal
lightrsi pi mode conservative
lightrsi pi mode normal
lightrsi opencode mode conservative
lightrsi opencode mode normal

# Or inside OpenClaw session
/lightrsi mode aggressive

The new mode takes effect on the next turn.

Next

• Stable Prefix — how stabilization works
• Context Reduction — the trimming pipeline
• Context Eviction — lifecycle-aware pruning