Skip to content

ADR-014-newchat-chat-folder-contract.md

Latest commit

 

History

History
23 lines (15 loc) · 1.24 KB

ADR-014-newchat-chat-folder-contract.md

File metadata and controls

23 lines (15 loc) · 1.24 KB

ADR-014: /newchat Creates Real Codex UI Chat Folders

Status: accepted

Date: 2026-05-05

Context

/projects treats threads under Documents/Codex as Codex UI Chats. Before this ADR, /newchat created an App Server thread without a cwd and only marked it locally as Chats, so the result did not match Codex UI Chat folders such as Documents/Codex/2026-04-28/tool-call.

Decision

  • /newchat <prompt> creates a real cwd under CTR_GO_CODEX_CHATS_ROOT before calling App Server thread/start.
  • The default Chats root is ~/Documents/Codex; operators may override it with CTR_GO_CODEX_CHATS_ROOT.
  • New Chat cwd names are <root>/<YYYY-MM-DD>/<prompt-slug>, with numeric suffixes for collisions.
  • /newthread <prompt> is the no-Chat-folder escape hatch: it calls thread/start without a Telegram-selected cwd, but App Server may still attach the daemon default cwd.
  • App Server protocol is unchanged: thread/start receives either the generated Chat cwd or no Telegram-selected cwd.

Consequences

  • /projects -> Open Chats shows /newchat threads as real Codex UI Chats.
  • No arbitrary filesystem path is accepted from Telegram.
  • Existing no-cwd or default-cwd threads remain supported through /newthread and older cached rows.