opentrench
One live feed for your Discord channels and Telegram chats, with contract
addresses highlighted and copyable. Runs entirely on your machine.
Community: questions, feature requests and release news in the
opentrench Discord. New here? Start with
Getting started. What changed: CHANGELOG.
Screenshots
The column terminal: All Calls, All Chats and a Top Callers leaderboard over
fake chats and callers.
Click a token's image for the drill-down: candles on a market-cap axis with
every caller pinned where they called, and the full call list.
Settings: a sidebar of pages, here Market data with the per-chain RPC table
and the live-price status.
Together: a room card with its members online, Copy invite, Rotate and Leave,
and the create / join forms under it.
Discord connects through a small plugin for Vencord or BetterDiscord inside your own Discord app, so there is no token and no self-bot session. From 0.8.7 the desktop app installs it for you: ⚙ → Accounts → Discord → Set up Discord. Discord has to be open for that side of the feed to work. A user token still works as a read-only fallback. Website and setup guides: https://opentrench.app
OpenSea mint wallet: use a dedicated wallet, not one holding real funds. The private key is stored encrypted in config.json with a key kept in your OS keychain, but anyone who can run code as your user on this machine can still get at it. Mint transactions are irreversible once sent. MintGo and OpenSea expose no official public API for any of this; opentrench reads their unofficial web endpoints, which can change without notice.
Install
Download one file from the latest release
and open it. Nothing else needs installing: no Node, no npm, no git.
| Your machine | File |
|---|
| Mac, Apple Silicon (any Mac from 2020 on) | opentrench-x.y.z-arm64.dmg |
| Mac, Intel | opentrench-x.y.z.dmg (no arm64 in the name) |
| Windows | opentrench-Setup-x.y.z.exe |
A three-step checklist on first launch covers Discord, Telegram and channels;
the long version is Getting started or
https://opentrench.app/docs/.
Set up with Claude
The repo ships a Claude skill that walks a
new user through install, both accounts, channels and the usual snags. With
Claude Code:
git clone --depth 1 https://github.com/frogeth/opentrench /tmp/opentrench
mkdir -p ~/.claude/skills
cp -r /tmp/opentrench/skills/opentrench-setup ~/.claude/skills/
Then say "set up opentrench". Without git, paste the skill's text into any Claude chat.
Run from source (developers)
npm install
npm run build
npm start # http://127.0.0.1:3210
Dev mode with hot reload (http://localhost:5173):
npm run dev
Host a relay
Rooms run through a relay, a small server in relay/ that fans out
encrypted messages and cannot read them. There is no official relay. To start
a room you need a relay address: host your own (one command puts one on
Fly.io, in Docker, or behind Caddy on any Node host) or use a friend's.
Whoever creates the room picks the relay; the invite carries its address, so
people who join configure nothing. Every route, the environment
variables, the access code and what the operator can see:
docs/relay.md.
What the feed does
One Discord-style layout for both platforms. The rail on the far left has
★ All pinned on top, then your Discord servers and Telegram chats as icons
(each badged with its platform's logo, drag to reorder — the order is saved),
and +. The « next to ★ collapses the channel pane. The pane lists only
what's in your feed for the selected rail item: channels by category for a
server, everything (grouped by server / Telegram) for All. Then
Calls (one card per contract, newest call first) and Chats, both scoped
to whatever is selected; a focused chat groups messages by author like
Discord. The tab row under the header is a quick switcher across every watched
chat.
+ opens the picker: every server & channel, or every Telegram chat, with a
+ add / ✓ in feed toggle and a preview eye. Clicking a name previews
its recent history without adding it (a banner offers "+ add to feed").
Clicking a ticker under a message jumps to and flashes its card in Calls.
The search box matches text, authors, chats, tickers and addresses.
Settings (⚙) is one modal with a sidebar of pages: Accounts (Discord bridge
status, Telegram login), Feed (favorite callers & pings, blacklist, bots),
Market data (RPCs, Alchemy key, live-price status per chain), Trading
(Cove amounts, o1 key, OpenSea mint wallet), Together (rooms and the
same-network mode) and Plugins. Channels are managed in the sidebar, not
in settings.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
