codex - 💡(How to fix) Fix Session-scoped notes panel for Codex Desktop App (shared user/agent + private regions) [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#20138Fetched 2026-04-30 06:33:18
View on GitHub
Comments
2
Participants
2
Timeline
10
Reactions
1
Author
Timeline (top)
cross-referenced ×4labeled ×4commented ×2

Fix Action

Fix / Workaround

The current workaround is a side scratchpad in Apple Notes or a markdown buffer in another window, with manual copy-paste back into the chat each time. That fixes "a place to write" but not auto-injection, agent write-back, or scoping.

  • Prior art in this repo: #12973 (closed) proposed a "Notes" tab for the web variant and was closed by a collaborator for insufficient upvotes — not on merits. This proposal is for the desktop app specifically and adds the user/agent read-write split plus the auto-injection mechanic that #12973 didn't specify.
  • Distinct from existing memories (#19195, #13194): memories are cross-session and currently read-only (the model is told Never update memories. You can only read them.). Session notes would be session-scoped and writable from both sides — a different slot in the context-surface design space.
  • Related discussion: #323 (Persistent Memory / Document Planning.md Strategies) describes the workaround pattern this would replace.
  • Cross-platform parallel: the same proposal is filed at pingdotgg/t3code#2397 — useful if maintainers want to see how a sibling community is framing it.
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

App

What feature would you like to see?

A session-scoped "Notes" panel in the Codex Desktop App with two regions:

  1. Shared region — markdown, read/write by both user and agent. Auto-injected into the agent's system context every turn from durable host state, so it survives compaction by construction.
  2. Private region — markdown, user-only. Never sent to the model. Pure UI scratchpad.

Behavior:

  • Scoped to the thread/session; persists across app restarts and session resume.
  • Shared region is delimited in the system prompt with clear tags (e.g. <session_notes>…</session_notes>) so the model knows what it is.
  • A toggle to disable shared-region injection without deleting the content.
  • Soft size cap (~2 KB) with a UI warning above the threshold.

Why this matters

In long sessions, instructions specific to this session — e.g. "always run the script with --flag X", "the task list for this PR is …", "the convention I just decided on for this thread" — get lost to compaction. They don't belong in AGENTS.md (project-permanent, committed) or in the existing memories feature (cross-session, currently read-only per #19195). There's no slot today for session-scoped, compaction-durable, dual user/agent read-write context.

The current workaround is a side scratchpad in Apple Notes or a markdown buffer in another window, with manual copy-paste back into the chat each time. That fixes "a place to write" but not auto-injection, agent write-back, or scoping.

Additional information

  • Prior art in this repo: #12973 (closed) proposed a "Notes" tab for the web variant and was closed by a collaborator for insufficient upvotes — not on merits. This proposal is for the desktop app specifically and adds the user/agent read-write split plus the auto-injection mechanic that #12973 didn't specify.
  • Distinct from existing memories (#19195, #13194): memories are cross-session and currently read-only (the model is told Never update memories. You can only read them.). Session notes would be session-scoped and writable from both sides — a different slot in the context-surface design space.
  • Related discussion: #323 (Persistent Memory / Document Planning.md Strategies) describes the workaround pattern this would replace.
  • Cross-platform parallel: the same proposal is filed at pingdotgg/t3code#2397 — useful if maintainers want to see how a sibling community is framing it.

extent analysis

TL;DR

Implement a session-scoped "Notes" panel in the Codex Desktop App with shared and private regions to store and auto-inject context-specific information.

Guidance

  • Review prior art in the repository, such as #12973, to understand the history and evolution of the "Notes" feature proposal.
  • Consider the differences between the proposed "Session Notes" and existing "memories" features, including session scoping and read-write capabilities.
  • Evaluate the auto-injection mechanic and its potential impact on the agent's system context and compaction.
  • Investigate the feasibility of implementing a toggle to disable shared-region injection without deleting content.

Example

No code snippet is provided as the issue focuses on feature proposal and design discussion.

Notes

The proposal is specific to the Codex Desktop App and may not be directly applicable to other variants or platforms.

Recommendation

Apply workaround: Implement the proposed "Session Notes" feature with shared and private regions, auto-injection, and a toggle for shared-region injection, as it addresses a specific pain point in long sessions and provides a unique solution not covered by existing features.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Session-scoped notes panel for Codex Desktop App (shared user/agent + private regions) [2 comments, 2 participants]