listeningkit-log

log for Hermes

Run your social conversations from Hermes. This plugin connects Hermes to log by ListeningKit, an open-source tool that reads and sends from your own X, Discord, Slack, Instagram and Reddit accounts. LinkedIn sign-in status is available; LinkedIn conversation reads and sends are not built yet.

Ask Hermes things like:

"Who messaged me on X and Discord today, and who's waiting on a reply?"
"Read my thread with @someone and draft an answer the way I'd write it."
"Follow up with everyone who opened my DM but didn't reply."

Hermes reads freely. Every send, reply or post asks you first.

What's inside

An Agent Plugins v1 package:

mcp.json: starts log's MCP server (logMcp) on your machine over stdio. Hermes gets log's tools as mcp__log__*: DM inboxes, conversation reads, session checks, search across past conversations, the voice check, and the send/reply/quote tools.
plugin.json: marks the log server untrusted, so every tool not annotated read-only (anything that sends or changes an account) asks for approval and is refused in cron and other unattended runs. The tool-call timeout is 600 s, because a platform read can take a while.
skills/dm-inbox: how to find who needs a reply and answer them: read the whole thread, pull how you actually write to that person, draft, check the draft, send only on your go.
skills/outreach: replies, quotes and follow-ups in your voice.

Install

Install log and sign in your accounts (it keeps them on your machine). With Bun:
```
bun add -g @listeningkit/log
log launch --setup
```
log's install guide also has a one-line installer that sets up Bun and the Python its platform engines use. Check logMcp is on your PATH.

Install and enable the plugin:

hermes plugins install deepmroot/listeningkit-log --no-enable
hermes plugins enable listeningkit-log

Disclosure

Local process: the plugin runs logMcp from your log install as a long-running stdio process while Hermes is open. It is not bundled here; you install log yourself.
Network calls: log calls the platforms you signed in (X, Discord, Slack, Instagram and Reddit, plus LinkedIn for its session check) directly, as your own accounts, and only when a tool runs. This plugin adds no telemetry and sends nothing anywhere else.
Data and credentials: your account sessions, cookies and message history stay in log's own folder on your machine (~/.logCli). The plugin never reads them; only log does. Nothing is put in mcp.json.
Writes: sends, replies, quotes, likes and follows go out as you, so they are gated by Hermes approval (trust: untrusted) and by log's own per-account daily limits. log stops on any rate limit, block or failed send instead of retrying.
The tool set comes from your installed log version at runtime and is not covered by this plugin's pinned commit.

License

MIT

README from the reviewed commit dd8960d; it updates when the author re-pins.

About