@akonwi/opencode-kit

OpenCode plugin package for local workflow notifications and runtime toggles.

Features

• Idle notification with terminal bell and optional speech.
• Error notification with macOS Funk sound only (no speech).
• Runtime config reads from ~/.config/opencode/kit.json.
• Structured JSON-line logs at ~/.config/opencode/logs/opencode-kit.log.
• Local control CLI (no AI turn): oc-kit.
• In-chat handoff command: /handoff creates a compacted successor session.

Install

bun add @akonwi/opencode-kit

Register the plugin in your OpenCode plugin config by loading @akonwi/opencode-kit and the OpencodeKit export.

Config

File: ~/.config/opencode/kit.json

{
  "bells": {
    "enabled": true,
    "errorSound": "Funk"
  },
  "speech": {
    "enabled": true,
    "maxChars": 220,
    "voice": null
  },
  "debug": {
    "logLevel": "info"
  }
}

If the file is missing or invalid, safe defaults are used.

CLI

oc-kit bells on
oc-kit bells off
oc-kit bells toggle
oc-kit bells status

oc-kit speech on
oc-kit speech off
oc-kit speech toggle
oc-kit speech status

The plugin re-reads kit.json at runtime so changes apply without restart.

Handoff Command

Run /handoff <next prompt> inside an active OpenCode session.

Current behavior:

• Uses the current session ID as the handoff reference.
• Builds a compact summary from recent source-session messages.
• Creates a new session via API and seeds it with an initial prompt.
• Opens the TUI session selector so you can jump directly into the new session.
• Seeded prompt includes:
  • your <next prompt> instruction,
  • compact summary context,
  • source session ID.

This uses OpenCode's default session storage/location.

Development

bun install
bun run format
bun run lint
bun run build