Browse docs

Core Concepts

Auto-compaction

Auto-compaction summarizes session history to retain meaning while freeing room for continued work.

What auto-compaction is

Auto-compaction is an automatic context summarization pass. Instead of carrying full long history forever, Spatial keeps core meaning in a compact form.

This helps maintain continuity while making space for new conversation and reducing context overload.

When it runs

  • Default threshold is 85% context usage.
  • It runs when usage reaches or exceeds that threshold.
  • It is designed for coding requests and skipped for max-mode requests.
  • Supported threshold range is 5% to 95% where configurable.

Current default

The current default threshold is 85%.

What to expect after compaction

  • Core intent and recent important user context are retained.
  • You can continue the session without manually rebuilding everything.
  • If precision is critical, restate constraints after compaction for strongest alignment.