Skip to main content
Configure context optimization behavior via CLI flags and interactive commands.

​
CLI Flags

​
Strategy

# Smart optimizer (default, recommended)
praisonai chat --context-strategy smart

# Simple truncation
praisonai chat --context-strategy truncate

# Sliding window
praisonai chat --context-strategy sliding_window

# Summarize old messages
praisonai chat --context-strategy summarize

# Prune old tool outputs
praisonai chat --context-strategy prune_tools
StrategyDescriptionBest For
smartIntelligent combinationGeneral use
truncateRemove oldest messagesFast, simple
sliding_windowKeep recent N messagesConversation flow
summarizeCompress old messagesContext preservation
prune_toolsTruncate tool outputsTool-heavy workflows

​
Auto-Compaction

# Enable (default)
praisonai chat --context-auto-compact

# Disable
praisonai chat --no-context-auto-compact

​
Threshold

# Trigger at 80% usage (default)
praisonai chat --context-threshold 0.8

# More aggressive (70%)
praisonai chat --context-threshold 0.7

# Less aggressive (90%)
praisonai chat --context-threshold 0.9

​
Interactive Commands

​
Manual Compaction

> /context compact
Output: 
Optimizing context...
✓ Optimized: 45,000 → 30,000 tokens
Saved 15,000 tokens (33.3%)
Strategy: smart

​
View Optimization History

> /context history
Output: 
Optimization History
Time                     Event                Tokens       Saved
----------------------------------------------------------------------
2024-01-07T12:00:00      overflow_detected       45,000          -
2024-01-07T12:00:01      auto_compact           45,000     -15,000

​
View Current Config

> /context config
Shows auto_compact, threshold, and strategy settings.

​
Environment Variables

export PRAISONAI_CONTEXT_AUTO_COMPACT=true
export PRAISONAI_CONTEXT_THRESHOLD=0.8
export PRAISONAI_CONTEXT_STRATEGY=smart

​
config.yaml

context:
  auto_compact: true
  compact_threshold: 0.8
  strategy: smart
  compression_min_gain_pct: 5.0
  compression_max_attempts: 3

​
Strategy Details

Combines multiple strategies intelligently:
  1. First tries non-destructive pruning
  2. Falls back to sliding window
  3. Uses truncation as last resort
praisonai chat --context-strategy smart

​
Truncate

Simply removes oldest messages until under budget. 
praisonai chat --context-strategy truncate

​
Sliding Window

Keeps the most recent N messages that fit in budget. 
praisonai chat --context-strategy sliding_window

​
Summarize

Compresses old messages into a summary (requires LLM call). 
praisonai chat --context-strategy summarize

​
Prune Tools

Truncates old tool outputs while preserving recent ones. 
praisonai chat --context-strategy prune_tools

​
Troubleshooting

​
Context still overflowing

# Lower threshold
praisonai chat --context-threshold 0.6

# Use more aggressive strategy
praisonai chat --context-strategy truncate

​
Losing important context

# Use smart strategy
praisonai chat --context-strategy smart

# Or increase threshold
praisonai chat --context-threshold 0.9

​
Auto-compact not triggering

# Check if enabled
> /context config

# Verify threshold
> /context stats