TUI keys
| Key | Action |
|---|---|
↑ / ↓ | move selection |
Home / End / G | jump to the first / last row |
Enter | resume the selected session (suspends szpont, returns on exit) |
E | resume and replace the szpont process |
n | new session (tool picker; 1–9 picks a tool directly) |
c | mark as completed: enters marking mode on the selected session; keep marking with c, move with ↑ / ↓, confirm with Enter, cancel with Esc or q |
u | reopen (archive screen) |
d | mark for deletion (works on every session screen, including the live list): same marking flow with d / Enter / Esc or q. Deletion removes the session from szpont and from the tool's own storage (codex delete; file removal for Claude Code and Kimi, which have no delete command). Sessions still open in a tool are skipped. |
v | tree view — sessions nested by directory with branch lines; works from monitor, repo scope and archive; v or Esc returns |
p | toggle scope — global (all repos) vs local (current repo); shown only when inside a repo |
o | options screen — set the context window per model (e.g. 200K, 1M); persisted, used for the CTX bar when the tool does not report a window (Claude Code) |
a | archive screen |
m | rename the selected session (szpont-side custom title; survives rescans) |
Esc | back from archive or tree view · clear marks · clear filters — one step per press |
l | limit usage popup (any key closes it) |
i | session detail popup (any key closes it) |
f | find (fzf-style fuzzy search: subsequence match over title, prompt, path and tool; filters live while typing, best matches first; works on every session view) |
Tab | cycle tool filter (Shift+Tab goes in reverse) |
r | force rescan (min 3s between scans; idle tick every 15s; file changes trigger scans automatically) |
double Ctrl+C | quit |
Reading the display
The STATUS column shows:
| Status | Meaning |
|---|---|
RUNNING (green) | the tool is working |
BLOCKED (yellow) | waiting for your input (reported for Claude Code only) |
IDLE (cyan) | open at the prompt — for Codex and Kimi this means a tool process has the session's directory open |
| (empty) | session not loaded in any process |
The list always sits in a tinted frame that names the mode: neutral " sessions ", magenta " archive ", yellow " marking as completed ", red " marking for deletion ", green " new session ", cyan " options ".
Background rescans never reorder the list under you: updates that keep the visible row order (token counts, status changes) apply live, while updates that would add, remove or reorder rows are held — the top bar shows "⟳ list changed — press r to refresh". r applies the held update instantly and rescans; your own actions (resume, complete, delete) always apply immediately too.
The CTX column shows context-window usage as used/window token counts with a fill bar when the window size is known (Codex reports it in its rollout; Kimi's comes from ~/.kimi-code/config.toml), otherwise the raw token count of the last request (Claude Code does not record its window size locally — set it once per model in the o options screen).