Skip to content

Automatic capture works out of the box on Codex CLI and Desktop - #55

Merged
jsirish merged 2 commits into
mainfrom
claude/codex-automatic-capture-confirmed
Aug 26, 2026
Merged

Automatic capture works out of the box on Codex CLI and Desktop#55
jsirish merged 2 commits into
mainfrom
claude/codex-automatic-capture-confirmed

Conversation

@jsirish

Copy link
Copy Markdown
Member

Summary

Corrects the README and promo site to reflect actual current Codex behavior, confirmed live from a genuinely out-of-the-box config (no prior trust state, no custom profiles):

  • Codex CLI shows a native "Hooks need review" dialog on first use in a project with throughline installed — "Trust all and continue" is the entire setup step, and it isn't asked again (trust is content-hash-based, not per-project).
  • Codex Desktop grants trust silently, no dialog.

Both confirmed via real captured buffer content in fresh test projects, not just config inspection.

Replaces the "Advanced: enabling automatic capture (unsupported)" README section (added in #53/#54, since obsolete) and the promo site's "no automatic capture - trust-gated" framing with the actual current behavior: full parity with Claude Code, gated only by a usually-invisible one-time trust step.

No code changes — .claude-plugin/.codex-plugin manifests are untouched. This was always true of the shipped plugin; the prior docs had it wrong.

Closes#52.

Test plan

  • /local-ci — 167/167 pass, manifest checks pass
  • Rendered locally and visually verified via browser automation (Codex CLI card + capability matrix)
  • Underlying claims verified live: fresh codex exec/interactive CLI session and fresh Desktop session both captured real buffer content from a reverted, untouched Codex config

🤖 Generated with Claude Code

https://claude.ai/code/session_013cG9PVNGundwPjNB4Yz5AS

jsirishand others added 2 commits August 25, 2026 19:46
Live testing from a genuinely reverted, out-of-the-box Codex config (no
prior trust state, no custom profiles) found that neither the workaround
documented in PR #53/#54 nor issue #47's "not wired" conclusion holds up:
- Codex CLI shows a native "Hooks need review" dialog on first use in a
project with throughline installed - choosing "Trust all and continue" is
the entire setup step.
- Codex Desktop grants trust silently, no dialog at all.
Both confirmed via real captured buffer content, not just config state.
Replaces the "Advanced: enabling automatic capture (unsupported)" README
section and the promo site's "no automatic capture - trust-gated" framing
with the actual current behavior: full parity with Claude Code (skills + all
5 hooks), gated only by a one-time trust step that's usually invisible.
.claude-plugin and .codex-plugin manifests are unchanged - this was always
true of the shipped plugin; the prior docs just had it wrong. Closes#52.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013cG9PVNGundwPjNB4Yz5AS
/review-pr on PR #55 found:
- CHANGELOG.md's v0.13.0 entry still asserted "skills only, not automatic
capture" and "so the skills-only framing stands" for the currently-shipped
release - a false statement about installed code, not just stale history.
Added an [Unreleased] correction entry and bracketed corrections inline in
the released 0.13.0 block (never rewriting released history silently).
- The new PreCompact paragraph narrated the investigation ("hasn't been
directly observed") rather than stating current behavior - violates the
writing-style rule added to global CLAUDE.md this same session. Dropped
the hedge; PreCompact installs and runs identically to the other four
events already confirmed firing, so there's no basis to single it out.
This also fixes the matrix/prose inconsistency the review flagged
(Compaction survival: yes in the table, hedged in prose).
- "isn't asked again for this project or any other" overstated permanence -
the dialog's own text says "new or changed," meaning a throughline release
that touches hook scripts re-triggers it. Corrected.
- Neither the README's Codex section nor the promo site's Codex card stated
the jq requirement, despite both matrices now claiming it - added
Requirements notes matching the Claude Code sections' existing pattern.
- Trimmed an overlong layout-tree comment that broke horizontal alignment.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013cG9PVNGundwPjNB4Yz5AS
@jsirish
jsirish merged commit 1d3cbc4 into mainAug 26, 2026
2 checks passed
@jsirish
jsirish deleted the claude/codex-automatic-capture-confirmed branch August 26, 2026 00:52
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Research: find a repeatable path to Codex hook trust for Desktop/CLI users

1 participant

@jsirish