@thesammykins/tether 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# @thesammykins/tether
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@thesammykins/tether)
|
|
4
|
+
[](./LICENSE)
|
|
5
|
+
|
|
3
6
|
Discord bot that bridges messages to AI coding agents. Supports Claude Code, OpenCode, and Codex CLI.
|
|
4
7
|
|
|
5
8
|
Fork of [cord](https://github.com/alexknowshtml/cord) with multi-agent support and enhanced features.
|
|
@@ -7,6 +10,7 @@ Fork of [cord](https://github.com/alexknowshtml/cord) with multi-agent support a
|
|
|
7
10
|
## Features
|
|
8
11
|
|
|
9
12
|
- **Multi-agent support** — Claude Code, OpenCode, Codex (switch via `AGENT_TYPE` env var)
|
|
13
|
+
- **BRB mode** — Agent asks questions via Discord buttons; `tether ask` blocks until answered
|
|
10
14
|
- **Direct messages** — Chat with the bot privately via DMs (opt-in)
|
|
11
15
|
- **Access control** — User, role, and channel allowlists
|
|
12
16
|
- **Rate limiting** — Per-user sliding window
|
|
@@ -26,6 +30,14 @@ Fork of [cord](https://github.com/alexknowshtml/cord) with multi-agent support a
|
|
|
26
30
|
|
|
27
31
|
### Install
|
|
28
32
|
|
|
33
|
+
From the npm registry (requires [Bun](https://bun.sh)):
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
bun add @thesammykins/tether
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Or clone from source:
|
|
40
|
+
|
|
29
41
|
```bash
|
|
30
42
|
git clone https://github.com/thesammykins/tether.git
|
|
31
43
|
cd tether
|
|
@@ -273,9 +285,10 @@ bun test tests/integration/ # Integration tests only
|
|
|
273
285
|
|
|
274
286
|
## CLI Commands
|
|
275
287
|
|
|
276
|
-
See [skills/tether/SKILL.md](./skills/tether/SKILL.md) for full CLI documentation.
|
|
277
|
-
|
|
278
288
|
Quick reference:
|
|
289
|
+
- `tether start` — Start bot + worker
|
|
290
|
+
- `tether stop` — Stop all processes
|
|
291
|
+
- `tether status` — Show running status
|
|
279
292
|
- `tether send <channel> "message"` — Send text message
|
|
280
293
|
- `tether embed <channel> "text" --title "T"` — Send formatted embed
|
|
281
294
|
- `tether file <channel> ./file.txt` — Send file attachment
|
|
@@ -284,12 +297,11 @@ Quick reference:
|
|
|
284
297
|
- `tether dm <user-id> "message"` — Send a DM to a user (proactive outreach)
|
|
285
298
|
- `tether dm <user-id> --embed "text" --title "T"` — Send an embed DM
|
|
286
299
|
- `tether dm <user-id> --file ./report.md` — Send a file via DM
|
|
300
|
+
- `tether ask <channel> "question" --button "Yes" --button "No"` — Ask a question via buttons, blocks until answered
|
|
287
301
|
|
|
288
302
|
## HTTP API
|
|
289
303
|
|
|
290
|
-
Tether exposes an HTTP API on port 2643 for external scripts and webhooks.
|
|
291
|
-
|
|
292
|
-
See [skills/tether/HTTP-API.md](./skills/tether/HTTP-API.md) for API documentation.
|
|
304
|
+
Tether exposes an HTTP API on port 2643 for external scripts and webhooks. See the [API documentation](./skills/tether/HTTP-API.md) for details.
|
|
293
305
|
|
|
294
306
|
## Troubleshooting
|
|
295
307
|
|