source-command-latch-compact

source-command-latch-compact

Use this skill when the user asks to run the migrated source command latch-compact from Codex.

Command Template

Run a compaction pass for the current Codex session against the per-project knowledge base managed by the selected latch checkout.

Use the Codex-specific wrapper. Do not use bin/run_compact_now.sh from Codex: that wrapper is Claude-shaped and may select a ~/.claude/projects transcript. The Codex wrapper resolves the session from the first argument or $CODEX_THREAD_ID, validates the matching ~/.codex/sessions/**/rollout-*.jsonl by session_meta.payload.id, and fails closed when it cannot prove the transcript.

This combines/overwrites the prior session_summary node with the latest state (see src/compactor.py). By default the Codex wrapper uses the Codex-native codex exec summarizer backend. Pass --summarizer claude only when intentionally testing the legacy shared Claude CLI backend.

Steps:

1. Prefer the current Codex session id from $CODEX_THREAD_ID. If the environment does not expose it, ask the user for the Codex session id and pass it as the first positional argument. Do not infer from Claude transcripts.

2. Launch the Codex compactor with the Bash tool. Prefer --background --wait unless the user explicitly asks to keep the shell in the foreground or to fire-and-forget:

   latch_home="${LATCH_HOME:-}"
   if [ -z "$latch_home" ] && [ -n "${CLAUDE_KB_HOME:-}" ]; then
     latch_home="$CLAUDE_KB_HOME"
   fi
   if [ -z "$latch_home" ]; then
     search_dir="$PWD"
     while [ "$search_dir" != "/" ]; do
       if [ -f "$search_dir/AGENTS.md" ]; then
         latch_home="$(sed -n 's|.*Follow `\([^`]*\)/README\.md` per-user setup.*|\1|p' "$search_dir/AGENTS.md" | head -n 1)"
         [ -n "$latch_home" ] && break
       fi
       search_dir="$(dirname "$search_dir")"
     done
   fi
   if [ -z "$latch_home" ]; then
     candidate="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
     if [ -f "$candidate/src/mcp_server.py" ] && [ -d "$candidate/commands" ]; then
       latch_home="$candidate"
     fi
   fi
   if [ ! -x "$latch_home/bin/run_codex_compact_now.sh" ]; then
     echo "Could not find latch checkout; set LATCH_HOME to your latch install." >&2
     exit 1
   fi
   bash "$latch_home/bin/run_codex_compact_now.sh" --background --wait