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
| Feature | Description |
|---|---|
| Auto-generated titles | Watches conversation and generates descriptive session names |
| Idle-triggered updates | Updates automatically when you stop typing |
| No API keys needed | Uses OpenCode’s unified auth — works with any authenticated provider |
| Smart model fallbacks | Optionally pin a specific model, or let the plugin choose |
| 100% TypeScript | Lightweight, 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
| Field | Default | Description |
|---|---|---|
enabled | true | Enable or disable the plugin |
debug | false | Enable debug logging |
model | smart fallback | Specific AI model to use for title generation |
updateThreshold | 1 | Update title every N idle events |
Links
- GitHub Repository — Source code and issues
- Awesome OpenCode — Browse more plugins