Skip to content
    ↑↓ select↵ openesc close
    English中文
    hyakt

    Smart Title

    v0.1.10Other
    @hyakt/opencode-smart-title

    OpenCode plugin that automatically generates meaningful session titles using AI and smart context selection

    Actively maintained
    #opencode#opencode-plugin#plugin#session-title#auto-title#ai
    GitHub reponpm pageHomepage
    GitHub stars

    0

    Monthly installs

    16

    7 in 7 days

    Composite scoreSCORE

    22.7

    Multi-signal model

    Last commit

    3 months ago

    2026-05-18

    Install and configure

    opencode.json

    Writes to this project's opencode.json — applies to this repository only.

    opencode.json

    {
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@hyakt/opencode-smart-title@0.1.10"]
}

    opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

    README.md
    View original→

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

    Forked from @tarquinen/opencode-smart-title.

    What Changed (Why This Fork)

    The original plugin uses @tarquinen/opencode-auth-provider + ai SDK to call LLM APIs directly from the plugin. This approach has a compatibility issue: the auth-provider's custom fetch wrapper returns undefined instead of a proper Response object when used with the github-copilot provider, causing extractResponseHeaders(response) to crash with TypeError: undefined is not an object.

    This fork replaces the direct API call with OpenCode's subagent session API (client.session.create / client.session.prompt), delegating LLM calls to OpenCode itself.

    Benefits

    • Works with all providers including github-copilot (no auth-provider fetch bug)
    • Removed 3 heavy dependencies: ai, @ai-sdk/openai-compatible, @tarquinen/opencode-auth-provider
    • Custom prompt support via prompt config field

    What It Does

    • Watches your conversation and generates short, descriptive titles
    • Updates automatically when the session becomes idle (you stop typing)
    • Delegates LLM calls to OpenCode via subagent sessions - no direct API calls
    • Works with any provider that OpenCode supports

    Installation

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

    {
  "plugin": ["@hyakt/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 (format: "provider/model")
  // "model": "github-copilot/claude-haiku-4.5",

  // Optional: Custom prompt for title generation
  // "prompt": "Generate a short Japanese title for this conversation.",

  // Update title every N idle events (1 = every time you pause)
  "updateThreshold": 1
}

    License

    MIT