Smart Title Plugin

Auto-generates meaningful session titles for your OpenCode conversations using AI.

What It Does

• Watches your conversation and generates short, descriptive titles
• Updates automatically when the session becomes idle (you stop typing)
• Uses OpenCode's unified auth - no API keys needed
• Works with any authenticated AI provider

Installation

npm install @tarquinen/opencode-smart-title

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

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

Configuration

The plugin supports both global and project-level configuration:

• Global: ~/.config/opencode/smart-title.jsonc - Applies to all sessions
• Project: .opencode/smart-title.jsonc - Overrides global config

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
}

License

MIT