Add message counter/turn number placeholder for multi-turn sessions

[bestK]

Feature Request

Problem

Currently, notifications only support two placeholders: {sessionTitle} and {projectName}. In a single conversation, there can be multiple question/answer interactions (e.g., multiple question events), and users cannot distinguish between them in the notification message.

Proposed Solution

Add a {turn} or {messageCount} placeholder that increments for each notification within a session. This would allow users to see which turn/question triggered the notification.

Example:

• [问题] {sessionTitle} (Turn {turn})
• Output: [问题] Fix bug #123 (Turn 1)
• Output: [问题] Fix bug #123 (Turn 2)

Alternative consideration

If implementing a session-based counter is too complex, consider adding {timestamp} placeholder with a simple format like HH:MM:SS to differentiate messages by time.

Use case

Users who integrate notifications with external systems (Telegram, Slack, etc.) need to distinguish between multiple interactions within the same session.

[mohak34]

Hey @bestK, the turn or the messageCount approach would require state management which would just complicate the plugin a lot but the alternative timestamp can be added with no issues. Ill implement the timestamp feature and release it after the current beta version is out of testing. Thanks for the idea.

[mohak34]

Hey @bestK, I've implemented both {timestamp} and {turn} placeholders. They're available in the beta now.

• {timestamp} -- current time in HH:MM:SS format
• {turn} -- global notification counter that persists across restarts

You can use them in custom messages like:

{
  "messages": {
    "complete": "[{turn}] Session finished at {timestamp}: {sessionTitle}"
  }
}

They also work in custom command args.

To try it out, switch to the beta tag:

{
  "plugin": ["@mohak34/opencode-notifier@beta"]
}

Then clear the cache and restart:

rm -rf ~/.cache/opencode/node_modules/@mohak34/opencode-notifier

Let me know if it works for you. Will be pushing to @latest soon.

[bestK]

THX