@tarquinen/opencode-smart-titleOpenCode plugin that automatically generates meaningful session titles using AI and smart context selection
50
551
93 in 7 days
37.8
Multi-signal model
7 months ago
2025-12-25
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@tarquinen/opencode-smart-title@0.1.7"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@tarquinen/opencode-smart-title@0.1.7"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D @tarquinen/opencode-smart-titleopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
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