Docs CLI

coding.sh ingest

Move captured hook events from the spool into the index. Every option of coding.sh ingest, from its own --help.

coding.sh ingest --help
coding.sh ingest [options]

  Move captured hook events from the spool into the index

Options
      --backfill       Also import agents' local transcript history
      --rebuild        Re-parse every stored session (of --agent) from its transcript and spool with the current adapters
  -a, --agent <AGENT>  Only this agent (repeatable, or a comma list: a,b)
      --since <WHEN>   Only at or after this time: 7d, 12h, 30m, today, yesterday or a date. A date without a zone is local time: 2026-11-09 is local midnight
      --background     Don't wait for another ingest; exit quietly if one is running. With --backfill, imports history unless another import is running

Examples
  coding.sh ingest
  coding.sh ingest --backfill --since 30d
  coding.sh ingest --rebuild --agent pi

Notes
  Rarely needed: read commands, the viewer and the MCP server ingest first, and the hook starts one when a session ends.
  After an upgrade, sessions stored by an older adapter parse are re-parsed in the background. --rebuild does it for every session now; a session whose transcript and spool lines are gone keeps its rows, minus duplicates, and one the adapter now reads as a copy of another stored session is removed.
  Run in the foreground, it also folds sessions that have events but no session row, and sessions tagged fold:error; doctor counts both.

All commands · Global options