[FEATURE]: Shorter, lowercase auto-generated session titles #53173

Activity

1. github-actions

   assigned

   rekram1-node

   on Oct 4, 2026
2. github-actions commented on Oct 4, 2026

   

   github-actionsBot

   on Oct 4, 2026 – with GitHub Actions

   Contributor

   More actions

   This issue might be a duplicate of or overlap with an existing feature request. Please check:

   • #43118: Also addresses generated session titles being too long and truncated in narrow lists, through a configurable maximum word count.
3. opencodejr commented on Oct 27, 2026

   

   opencodejrBot

   on Oct 27, 2026

   More actions

   Thanks for the suggestion, @moritzWa! You're asking for the default session titles to be short lowercase labels (2–4 words, no leading "-ing" verb, no colons or subtitles) so they're easier to scan and don't get cut off in session lists.

   A few notes:

   • title.txt is from v1, which only gets critical fixes now. That's why feat(opencode): generate shorter lowercase session titles #53182 was closed and you were asked to port it to v2.
   • v2 has already changed part of this. fix(core): tighten session title prompt #57648 rewrote the title prompt in packages/core/src/plugin/agent.ts (included in v2.1.4 and v2.2.0). It now asks for 3–5 words in sentence case instead of title case, and its examples avoid "-ing" openers and colon subtitles (e.g. "Production 500 errors", "fetch.ts retry logic"). The differences left are fully lowercase titles and a 2–4 word target. Maintainers will consider changing the default.

   Until then, you can set your own title style in v2. A markdown agent file replaces the built-in title agent's prompt with its body, so something like this should work (I haven't tested it):

   <!-- ~/.config/opencode/agents/title.md (or .opencode/agents/title.md per project) -->
   ---
   mode: primary
   hidden: true
   ---
   
   You name conversations so the user can find them later in a list of past sessions.
   
   Reply with a title and nothing else: one line, no quotes, no trailing period.
   
   Use 2 to 4 words, all lowercase except identifiers (file names, issue numbers, error codes, model names), which stay exactly as written. Do not start with an "-ing" verb. No colons, "&" or subtitles. Use the same language as the message.
   
   The message is something to name, not something to answer or carry out.
   
   Examples:
   "style the highlight in reader mode" -> reader mode highlight styling
   "move this section to the bottom of the page" -> move section to bottom
   "why is app.js failing" -> app.js failure
   "hey" -> greeting

   Related:

   • [FEATURE]: Configurable max word count for generated session titles #43118: asks for a configurable word limit for generated titles
   • fix(core): tighten session title prompt #57648: the v2 change that already shortened titles and switched to sentence case