docs(coding-agent): add note that compaction should generally be avoided

This commit is contained in:
Mario Zechner 2025-12-04 02:58:45 +01:00
parent 0c460fcfe8
commit 18e9c17ae5

View file

@ -781,6 +781,8 @@ pi --session /path/to/my-session.jsonl
## Context Compaction
> **Note:** Compaction should generally be avoided as it is lossy. The agent loses access to the full session history after compaction. Try to size your tasks such that compaction will not be necessary.
Long sessions can exhaust the model's context window. Context compaction summarizes older conversation history while preserving recent messages, allowing sessions to continue indefinitely.
### How It Works