Skip to content

Smart Title

Smart Title

Smart Title watches your OpenCode conversation and generates short, descriptive titles automatically. When the session becomes idle (you stop typing), the plugin triggers AI to summarize what you’re working on and updates the session title.

Key Features

FeatureDescription
Auto-generated titlesWatches conversation and generates descriptive session names
Idle-triggered updatesUpdates automatically when you stop typing
No API keys neededUses OpenCode’s unified auth — works with any authenticated provider
Smart model fallbacksOptionally pin a specific model, or let the plugin choose
100% TypeScriptLightweight, no native dependencies

Installation

npm install @tarquinen/opencode-smart-title

Add to ~/.config/opencode/opencode.json:

{
  "plugin": ["@tarquinen/opencode-smart-title"]
}

Configuration

Both global and project-level config are supported:

  • Global: ~/.config/opencode/smart-title.jsonc
  • Project: .opencode/smart-title.jsonc

The plugin creates a default global config on first run:

{
  // Enable or disable the plugin
  "enabled": true,
  // Enable debug logging
  "debug": false,
  // Optional: Use a specific model (otherwise uses smart fallbacks)
  // "model": "anthropic/claude-haiku-4-5",
  // Update title every N idle events (1 = every time you pause)
  "updateThreshold": 1
}

Configuration Options

FieldDefaultDescription
enabledtrueEnable or disable the plugin
debugfalseEnable debug logging
modelsmart fallbackSpecific AI model to use for title generation
updateThreshold1Update title every N idle events