Claude Code Session Capture

Fraime.it can import a Claude Code JSONL transcript into a recorded project. The transcript provides prompt and tool timing, so Fraime.it can suggest speed ramps for long-running commands without guessing from the screen recording alone.

Record From Claude Code

When Claude Code calls fraimeit_start_recording, Fraime.it opens its recording window and uses a compact MCP elicitation sequence for capture quality, audio/camera toggles, optional device selection, and automatic effects. The active invoking window, such as iTerm or Claude Desktop, is proposed as the capture source. Microphone and camera pickers appear only when their toggles are enabled. Recording starts only after you accept the sequence.

The lower-level fraimeit_list_capture_sources and fraimeit_configure_recording tools remain available for automation and partial updates. Omitted settings retain their current values.

At the end of the session, call fraimeit_stop_recording. The tool waits only for macOS to finalize the movie and immutable recording sidecar, then opens the project immediately. Fraime.it displays post-processing progress in the Timeline Assistant while it:

1. Selects the matching top-level Claude Code transcript.
2. Imports session events and creates chapters.
3. Generates and saves reviewable pacing suggestions.

Processing state is stored in post-recording.json inside the project package, so interrupted or failed work does not leave an unexplained spinner. When suggestions arrive, Fraime.it keeps the Timeline Assistant visible for review. If multiple top-level sessions overlap equally, the processing card reports that a sessionId or transcriptPath is needed instead of guessing.

Import A Session

Open the recorded project, then call fraimeit_ingest_agent_session through the Fraime.it MCP server:

{
  "target": "/path/to/recording.fraimeit",
  "transcriptPath": "/Users/you/.claude/projects/.../session.jsonl"
}

The import stores agent-session.json in the project package. It does not modify the immutable recording sidecar and can be safely re-imported.

Generate Pacing Suggestions

Call fraimeit_run_agent_pacing after import. It creates reviewable speed-ups for meaningful long-running tools, Claude response generation, and substantial thinking before a response. For a tool or thinking span lasting at least 40 seconds, Fraime.it can instead propose cutting the inactive middle while retaining the lead-in and result reveal. Cuts require no keyboard, pointer, IDE, browser, decision, or error activity in the removed range. Terminal input can produce a reviewable 1.5× bottom-left zoom, while substantial streamed Claude responses can produce a subtle 1.2× left-aligned zoom. Applying either creates a normal editable zoom segment. Generic gaps, recording controls, tool discovery, sidechain work, and failed tools are ignored. Review every suggestion before applying it.

Privacy

Privacy analysis does not run when recording stops. Call fraimeit_run_redaction_ocr when a recording needs credential and authentication-URL review. Findings remain reviewable detections: Fraime.it does not automatically apply redactions. Review the full video and transcript-derived labels before publishing because prompts, commands, file paths, and sign-in links may still contain private information.