Sessions

Picking up where you left off

Resume yesterday's local thread, search this machine's saved sessions by what was said, and use shared recall across machines.

Terminal
csc --continue      # reopen the last local session in this project
csc --resume        # open the local session browser at launch

From inside a session, /resume opens the same browser.

The session browser

Type to filter. It searches session titles and what was actually said, so "the retry thing" finds the session where you discussed retries even if the title says something else.

Enter swaps that conversation in, in place — no restart, recent context replayed. From the same picker:

KeyAction
CtrlNRename
CtrlXDelete
CtrlEExport as markdown
EscClose

csc sessions does all of it from the shell.

Long sessions don't hit a wall

History is token-budgeted. When it fills, older turns fold into a summary automatically and the conversation carries on. A snapshot is bookmarked first, so the detail is recoverable even though it's no longer in the window.

/compact triggers the same fold early — useful before starting a big piece of work in a session that's been running all day.

Continue, or start fresh?

csc --continue when you're resuming the same piece of work — you want the thread. Plain csc when you're starting something else. Either way the project memory is there; only the conversation differs.

What follows you between machines

The resumable session files live on this machine under ~/.contextcode/sessions/. csc --continue, csc --resume, and csc sessions read that local history, so a laptop does not automatically gain the desktop's live session.

When you're signed in, completed exchanges and session snapshots are also sent to the project's shared ContextStream history on a best-effort basis. That means another machine or editor can answer "what did we do on the desktop?" through recall. It is shared knowledge, not a movable local session: you start a fresh conversation on the second machine and ask it to pick up from the record.

If it doesn't work

--continue opened the wrong session. It reopens the most recent one for this directory. Use /resume and pick.

The session I want isn't listed. The browser filters as you type — search for something that was said in it rather than the title. If the work happened on another machine, ask for it through project recall instead; it will not appear in this machine's local session browser.

It compacted and lost a detail. Ask for it. The pre-compaction snapshot is in memory even when it's out of the live window.

Next