save-context

Save Context

Save current session state to CONTEXT-{stream}-llm.md in the session directory with LLM-optimized format.

.context/session/
  INDEX.md                        index of streams
  CONTEXT-llm.md                  default stream
  CONTEXT-{name}-llm.md           named stream
  done/CONTEXT-{name}-llm.md      archived stream (status done or parked)

Target: 1200-1500 tokens MAX | Speed: 3-5 seconds

AskUserQuestion Guard

CRITICAL: After EVERY AskUserQuestion call, check if answers are empty/blank. Known harness bug affecting several agentic CLIs: outside Plan Mode, the AskUserQuestion tool can silently return empty answers without showing UI.

If answers are empty: DO NOT proceed with assumptions. Instead:

1. Output: "Questions didn't display (known AskUserQuestion bug outside Plan Mode)."
2. Present the options as a numbered text list and ask user to reply with their choice number.
3. WAIT for user reply before continuing.

Performance Rules

1. Use rtk for shell commands when it is installed (a harness hook may already rewrite them; bare commands are also fine)
2. Parallel tool calls — ALL independent calls in one message
3. Minimize round-trips — gather all data phase 1, reason phase 2, write phase 3

Workflow

Phase 1: Gather Data (parallel)

Bash: ls .context/session/ + ls -t .context/session/CONTEXT-*llm.md

Stream resolution: First word of $ARGUMENTS = stream name (^[a-zA-Z0-9_-]{1,50}$), rest = description. Empty → reuse prior /load-context stream or AskUserQuestion.

Phase 2: Analyze & Synthesize (single pass)

From conversation (last 15-20 messages):

1. Next — infer 3 tasks from conversation (IMPORTANT: use heading "Next" — several agentic CLIs' compaction routines grep-match next/todo/pending/remaining keywords for survival priority)
2. Session — progression, decisions, thinking, unexpected (780 tokens max)
3. Hot Files — max 10 discussed/edited
4. Focus & Goal — 1-2 sentence focus + goal