codex-stop

Codex Stop Workflow

Stop Codex mode and restore normal direct-host behavior.

Procedure

1. Resolve the active host session id, then check whether the matching Codex marker exists:

   SIDEKICK_SESSION="${SIDEKICK_SESSION_ID:-${SIDEKICK_HOST_SESSION_ID:-${CODEX_THREAD_ID:-${CLAUDE_SESSION_ID:-${SESSION_ID:-}}}}}"
   test -n "${SIDEKICK_SESSION}" || { echo "No host session id found for Codex mode"; exit 1; }
   CODEX_STATE_ROOT="${HOME}/.codex"
   test -f "${CODEX_STATE_ROOT}/sessions/${SIDEKICK_SESSION}/.codex-delegation-active"
   

   • If yes: delete it and clear the shared active-sidekick marker only if it still points at Codex:

     rm -f "${CODEX_STATE_ROOT}/sessions/${SIDEKICK_SESSION}/.codex-delegation-active"
     ACTIVE_FILE="${HOME}/.sidekick/sessions/${SIDEKICK_SESSION}/active-sidekick"
     if [ -f "${ACTIVE_FILE}" ] && [ "$(cat "${ACTIVE_FILE}")" = "codex" ]; then
       rm -f "${ACTIVE_FILE}"
     fi
     

     Then confirm: "Codex sidekick mode deactivated for this session. Direct-host mode restored."
   • If no: confirm: "Codex sidekick mode is not currently active."

Notes

• .codex/conversations.idx is preserved across deactivation as the Sidekick-owned Codex audit ledger.
• Deactivation does not touch the local OpenAI Codex CLI's own runtime history or any project files.
• On Cursor, the sessionEnd hook also clears session-scoped Codex markers when the chat session ends.