OpenCode Plugins: Terminal Bell

opencode-env-protection-plugin.md

.env Protection

A simple OpenCode Plugin to block access to .env files.

How to Install?

On Linux, save env-protection.ts to ~/.config/opencode/plugin/env-protection.ts.

env-protection.ts

import type { Plugin } from "@opencode-ai/plugin"

export const EnvProtection = async ({ client, $ }) => {
  return {
    tool: {
      execute: {
        before: async (input, output) => {
          if (input.tool === "read" && output.args.filePath.includes(".env")) {
            throw new Error("Do not read .env files");
          }
        },
      },
    },
  };
};

Credit

lkhari

dkarter ~Advanced Version

opencode-terminal-bell-plugin.md

Terminal Bell

A simple OpenCode plugin to ring the terminal bell once a request is complete.

How to Install?

On Linux, save terminal-bell.ts to ~/.config/opencode/plugin/terminal-bell.ts.

terminal-bell.ts

import type { Plugin } from "@opencode-ai/plugin"

export const TerminalBell: Plugin = async ({ project, client, $, directory, worktree }) => {
  return {
    event: async ({ event }) => {
      if (event.type === "session.idle") {
        console.log("Session went idle")
        await Bun.write(Bun.stdout, "\x07")
      }
    }
  }
}

VS Code

If you are using VSCode & SSH, you need to enable terminalBell in the settings, in a project that will be .vscode/settings.json the settings file can be as simple as:

{
    "accessibility.signals.terminalBell": {
        "sound": "on",
        "announcement": "auto",
    }
}

Credit

CarlosGtrz

Here's an version of terminal bell for people on terminal emulators that don't support an audible terminal bell like alacritty

import type { Plugin } from "@opencode-ai/plugin"

export const TerminalBell: Plugin = async ({ project, client, $, directory, worktree }) => {
  return {
    event: async ({ event }) => {
      if (event.type === "session.idle") {
        // Play a system sound (audible bell)
        try {
          await $`paplay /usr/share/sounds/freedesktop/stereo/bell.oga`
        } catch (err) {
          console.warn("Failed to play audible bell:", err)
        }
      }
    }
  }
}

Use PowerShell for fine audio control.

import { type Plugin } from "@opencode-ai/plugin"

export const ChimePlugin: Plugin = async ({ $ }) => {
  return {
    event: async ({ event }) => {
      // session.idle is the only event we care about for "completion"
      if (event.type === "session.idle") {
        // This PowerShell command plays two distinct beeps
        // 800Hz for 100ms, then 1000Hz for 100ms
        await $`powershell.exe -c "[console]::beep(800, 100); [console]::beep(1000, 100)"`
          .quiet()
          .nothrow();
      }
    },
  };
};

For MacOS:

import type { Plugin } from "@opencode-ai/plugin";

export const TerminalBell: Plugin = async ({
  project,
  client,
  $,
  directory,
  worktree,
}) => {
  return {
    event: async ({ event }) => {
      if (event.type === "session.idle") {
        try {
          await $`afplay /System/Library/Sounds/Glass.aiff`;
        } catch (err) {
          console.warn("Failed to play audible bell:", err);
        }
      }
    },
  };
};

      if (event.type === "session.idle") {
        await Bun.write(Bun.stdout, "\x07")
        try {
          await $`afplay /System/Library/Sounds/Ping.aiff`;
        } catch (err) {
          console.warn("Failed to play audible bell:", err);
        }
      }

This is nice, gets the terminal bell (I have sound off, but I like to use the indication in tmux). Also Ping.aiff is louder it seems.

The terminal bell plugin is great, but the "session.idle" event seems to fire for subagents too, it's quite annoying...

I made a heavy-duty version of this here for Mac users. I looked at the above comments and tried to make it super user-configurable. Subagent firing is suppressed.