Retitler

The retitler.* fields configure the hidden agent behind the /retitler command. They affect session titles only. They do not change primary-agent behavior, model routing, or OpenCode’s manual rename behavior.

Defaults

Naming instructions

Use retitler.instructions for recurring title rules:

{
  "retitler": {
    "instructions": [
      "Use `<ticket-id> — <summary>` when a ticket ID is clearly present.",
      "Keep titles searchable; avoid slogans.",
      "Prefer the same language as the current conversation."
    ]
  }
}

Use the global file for personal naming preferences. Use project .opencode/squad.json for repository or ticket conventions.

For a one-time instruction, do not edit squad.json; pass it directly to the command:

/retitler Use a short title with the ticket ID first

Interactive suggestions

When retitler.suggestions is true, /retitler proposes three title options and asks you to choose one:

{
  "retitler": {
    "suggestions": true
  }
}

This is useful when title style is subjective or when you want review before the session is renamed. Keep it false when you prefer /retitler to be a quick one-command action.

Combined example

{
  "retitler": {
    "instructions": ["Use issue keys when present.", "Keep titles factual and searchable."],
    "suggestions": true
  }
}