> ## Documentation Index > Fetch the complete documentation index at: https://docs.praison.ai/llms.txt > Use this file to discover all available pages before exploring further. # Context Management CLI Reference > Complete CLI reference for context management commands and flags This page provides a complete reference for all context management CLI commands and flags. ## Interactive Commands Use these commands in `praisonai chat` or `praisonai code` interactive mode. ### /context Show context summary and statistics. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context ``` **Output:** ``` Context Summary Model: gpt-4o-mini Model Limit: 128,000 tokens Output Reserve: 8,000 tokens Usable Budget: 120,000 tokens Current Usage: 15,234 tokens (12.7%) Turns: 8 Messages: 16 Auto-Compact: enabled Monitoring: disabled ``` ### /context show Alias for `/context`. Shows summary view. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context show ``` ### /context stats Show detailed token ledger by segment. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context stats ``` **Output:** ``` Token Ledger Segment Tokens Budget Used -------------------------------------------------- system_prompt 1,200 2,000 60.0% history 12,500 84,616 14.8% tools_schema 1,534 2,000 76.7% -------------------------------------------------- TOTAL 15,234 120,000 12.7% ``` ### /context budget Show budget allocation details. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context budget ``` **Output:** ``` Budget Allocation Model Limit: 128,000 Output Reserve: 8,000 Usable: 120,000 Segment Budgets: System Prompt: 2,000 Rules: 500 Skills: 500 Memory: 1,000 Tool Schemas: 2,000 Tool Outputs: 20,000 History: 84,616 Buffer: 1,000 ``` ### /context dump Write context snapshot to disk immediately. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context dump ``` **Output:** ``` ✓ Context snapshot written to: ./context.txt ``` ### /context on Enable context monitoring. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context on ``` **Output:** ``` ✓ Context monitoring enabled Output: ./context.txt ``` ### /context off Disable context monitoring. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context off ``` ### /context path \ Set monitor output path. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context path ./debug/context.json ``` ### /context format \ Set monitor output format. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context format json ``` ### /context frequency \ Set monitor update frequency. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context frequency overflow ``` | Frequency | Description | | ----------- | ------------------------------- | | `turn` | Write after each turn (default) | | `tool_call` | Write after each tool call | | `manual` | Only write on `/context dump` | | `overflow` | Write when approaching limit | ### /context compact Trigger manual context optimization. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context compact ``` **Output:** ``` Optimizing context... ✓ Optimized: 45,000 → 30,000 tokens Saved 15,000 tokens (33.3%) Strategy: smart ``` ### /context history Show optimization event history. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /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 2024-01-07T12:05:00 snapshot 30,000 - Showing last 3 of 3 events ``` ### /context config Show resolved configuration with precedence info. ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} > /context config ``` **Output:** ``` Resolved Configuration Precedence: CLI > ENV > config.yaml > defaults Source: env Auto-Compaction: auto_compact: True compact_threshold: 0.8 strategy: smart compression_min_gain: 5.0% Budget: output_reserve: 8,000 default_tool_max: 10,000 Estimation: estimation_mode: heuristic log_mismatch: False Monitoring: monitor_enabled: False monitor_path: ./context.txt monitor_format: human monitor_frequency: turn monitor_write_mode: sync redact_sensitive: True Effective Budget: model_limit: 128,000 usable: 120,000 history_budget: 84,616 ``` ## CLI Flags Use these flags when starting `praisonai chat` or `praisonai code`. ### Auto-Compaction ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Enable auto-compaction (default) praisonai chat --context-auto-compact # Disable auto-compaction praisonai chat --no-context-auto-compact ``` ### Strategy ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-strategy smart ``` Options: `smart`, `truncate`, `sliding_window`, `summarize`, `prune_tools` ### Threshold ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-threshold 0.8 ``` Value: 0.0 to 1.0 (default: 0.8) ### Monitoring ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Enable monitoring praisonai chat --context-monitor # Set output path praisonai chat --context-monitor-path ./debug/context.json # Set format praisonai chat --context-monitor-format json # Set frequency praisonai chat --context-monitor-frequency overflow ``` ### Redaction ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Enable redaction (default) praisonai chat --context-redact # Disable redaction praisonai chat --no-context-redact ``` ### Output Reserve ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-output-reserve 16000 ``` ### Estimation Mode ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-estimation-mode validated ``` Options: `heuristic`, `accurate`, `validated` ### Mismatch Logging ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-log-mismatch ``` ### Snapshot Timing ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-snapshot-timing both ``` Options: `pre_optimization`, `post_optimization`, `both` ### Write Mode ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-write-mode async ``` Options: `sync`, `async` ### Show Config ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} praisonai chat --context-show-config ``` Shows resolved configuration and exits. ## Environment Variables ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Auto-compaction export PRAISONAI_CONTEXT_AUTO_COMPACT=true export PRAISONAI_CONTEXT_THRESHOLD=0.8 export PRAISONAI_CONTEXT_STRATEGY=smart # Monitoring export PRAISONAI_CONTEXT_MONITOR=false export PRAISONAI_CONTEXT_MONITOR_PATH=./context.txt export PRAISONAI_CONTEXT_MONITOR_FORMAT=human export PRAISONAI_CONTEXT_MONITOR_FREQUENCY=turn # Redaction export PRAISONAI_CONTEXT_REDACT=true # Budget export PRAISONAI_CONTEXT_OUTPUT_RESERVE=8000 # Estimation export PRAISONAI_CONTEXT_ESTIMATION_MODE=heuristic ``` ## config.yaml ```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} context: auto_compact: true compact_threshold: 0.8 strategy: smart output_reserve: 8000 monitor: enabled: false path: ./context.txt format: human frequency: turn write_mode: sync redact_sensitive: true estimation: mode: heuristic log_mismatch: false ``` ## Precedence Configuration is resolved in this order (highest to lowest): 1. **CLI flags** - `--context-*` flags 2. **Environment variables** - `PRAISONAI_CONTEXT_*` 3. **config.yaml** - `context:` section 4. **Defaults** - Built-in defaults ## Troubleshooting ### Context overflow errors ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Lower threshold to trigger earlier praisonai chat --context-threshold 0.7 # Use more aggressive strategy praisonai chat --context-strategy truncate ``` ### Monitor not updating ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Check if enabled > /context config # Enable and set frequency > /context on > /context frequency turn ``` ### Sensitive data in snapshots ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} # Ensure redaction is enabled praisonai chat --context-redact # Check patterns in snapshot > /context dump ```