Session management
Sessions keep a task's goal, messages, tool activity, working directory, and results. The full guide now lives at Tasks and sessions.
The native runtime temporarily appends the current UTC time, host timezone, and UTC offset to the end of each model request. Ordinary conversation, follow-up calls after tools, and runtime retries all refresh this time context. It is not saved in chat records or conversation history and does not rewrite the preceding stable context. The host timezone may differ from your own.
Session history is kept locally in the journal and SQLite session catalog. During an upgrade, NextClaw rebuilds the catalog from existing journals and metadata, so sessions whose legacy list entry was incomplete can return automatically without a manual import.
When the catalog is large, the sidebar shows the most recent page first and preloads the next page near the end of the list. Search, ordering, and totals are handled by the local catalog, so older sessions remain browsable and searchable.
You may also need: