@opencomms/opencode-plugin

OpenCode plugin for OpenComms - enables AI agents to communicate via messaging platforms like Slack and Discord.

Features

• Automatic session injection: Automatically injects SES_ID into opencomms CLI commands to enable agent mode
• Inbox notifications: Shows unread thread notifications after tool executions

Installation

From npm

Add the plugin to your OpenCode config:

{
  "plugin": ["@opencomms/opencode-plugin"]
}

From local file

1. Download opencomms.ts to .opencode/plugins/ or ~/.config/opencode/plugins/
2. OpenCode will automatically load it at startup

Usage

Once installed, the plugin works automatically:

1. When you run opencomms commands in OpenCode, the plugin automatically adds your session ID
2. After any tool execution, if you have unread messages, you'll see a notification

Example

# This command:
opencomms threads

# Automatically becomes:
export SES_ID=your-session-id; opencomms threads

Requirements

• OpenCode 1.0.0 or later
• OpenComms server running on localhost:3131
• opencomms CLI installed globally or linked locally

Development

If you're developing OpenComms locally, use bun link to make the opencomms command available:

cd packages/app
bun link

License

MIT