Skip to content

kcap setup: newest-first import, background remainder, and eval-watch agent handoff #641

Description

@realtonyyoung

Summary

Rework the final (import) step of kcap setup so the user sees immediate value from evals instead of staring at a full synchronous import:

  1. Newest-first ordering. Import sessions in reverse-chronological order so the most recent work lands first. Cross-chain order becomes newest-first by chain timestamp (today it is alphabetical by transcript slug, i.e. arbitrary); within-chain order stays ascending because it feeds previous_session_id continuation links. Applies to kcap import too.
  2. Background the remainder after 5 sessions. Setup's import runs in the foreground only until 5 sessions have successfully imported (chains are never split), then spawns a detached kcap import --repo <owner>/<name> --yes child (stream-redirected to a log file, setsid) for the rest. Import idempotency via the server watermark makes the partition automatic. The background child is spawned unconditionally — declining the agent handoff below does not affect it.
  3. Agent handoff. Setup then offers a picker of detected coding agents. CLI agents with a known launch recipe are launched in the foreground with the pinned watch prompt (Follow my kcap import); IDE-only installs and Skip fall back to printing the prompt to paste (same pattern as the guided tour).
  4. New eval-watch skill in the kcap plugin, triggered by Follow my kcap import: shows an immediate status snapshot, follows import/eval progress, stops after 3 completed evals with a summary of findings, links to full results in the tenant UI, and offers the Start kcap guided tour prompt.

Plain kcap import outside setup gets no prompt/handoff changes — only the ordering.

Evals are dispatched server-side on ingest; this change only observes them.

Design spec: docs/superpowers/specs/2026-08-21-setup-import-eval-handoff-design.md (rides the implementation PR).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions