[FEATURE]: Configurable max word count for generated session titles #43118

Activity

1. github-actions

   assigned

   nexxeln

   on Aug 17, 2026
2. moritzWa commented on Oct 5, 2026

   

   moritzWa

   on Oct 5, 2026

   More actions

   Related: #53182 shortens the default title prompt to 2–4 lowercase words (tracked in #53173). It doesn't add a config option, but it should make truncation in narrow session lists much less common. There's a before/after comparison in the PR.
3. opencodejr commented on Oct 28, 2026

   

   opencodejrBot

   on Oct 28, 2026

   More actions

   Thanks for the suggestion, @cmsflash! You're asking for an optional setting that caps generated session titles at a set number of words, so the words that tell sessions apart don't get cut off in narrow session lists. Maintainers will consider it.

   Some context. Since #57648 (in v2.1.4 and later), the built-in title prompt no longer targets ~50 characters; it asks for three to five words. If you're on an older v2, upgrading may already help. There's still no setting for a word cap, though.

   Until then, you can get this today in v2 with a small plugin that adds a word limit to the title request. I haven't tested it, so treat it as a starting point. Save it as ~/.config/opencode/plugins/title-max-words.ts, or .opencode/plugins/title-max-words.ts for a single project:

   import { Plugin } from "@opencode/plugin"
   
   const MAX_WORDS = 4
   
   export default Plugin.define({
     id: "title-max-words",
     setup: async (ctx) => {
       await ctx.session.hook("title", (event) => {
         event.system.push({
           type: "text",
           text: `Use at most ${MAX_WORDS} words in the title. Put the most distinguishing words first.`,
         })
       })
     },
   })

   This is an instruction to the model, not a hard limit. Another option is to replace the built-in title agent's prompt entirely with an agents/title.md file. The file's body becomes the title prompt, so you can write in whatever word limit you want.

   Related issues:

   • [FEATURE]: Shorter, lowercase auto-generated session titles #53173: asks for shorter, lowercase titles by default rather than a setting
   • [FEATURE]: add option to skip session title generation #33140: asks to skip title generation entirely (closed)
   • Long session titles produce unsavable export filenames #54721: long session titles make export filenames unsavable
4. cmsflash commented on Oct 28, 2026

   

   cmsflash

   on Oct 28, 2026

   Author

   More actions

   @moritzWa that PR is closed tho. BTW how did you get review on your PR? I was never able to get it.