Add irc

2026-08-12 23:50:49 -04:00
parent bbfe873414
commit 1187e30cf6
53 changed files with 6693 additions and 32 deletions
@@ -0,0 +1,37 @@
+{
+  "name": "irc",
+  "section": 1,
+  "title": "irc",
+  "synopsis": [
+    "irc [libera|HOST] [--tls|--plain] [--nick N]",
+    "irc send TARGET TEXT",
+    "irc join #channel",
+    "irc whois NICK",
+    "irc status"
+  ],
+  "description": "Modern IRC client (IRCv3 CAP LS 302). Default network is Libera.Chat over TLS at irc.libera.chat:6697. On a TTY, opens a full-screen ctx.tui session. Without a TTY, use send/join/whois/status. Config lives in ~/.irc/config.json; SASL secrets in ~/.irc/secrets.json.",
+  "options": [
+    {
+      "flag": "--tls",
+      "meaning": "Require TLS (default)."
+    },
+    {
+      "flag": "--plain",
+      "meaning": "Plaintext TCP. Blocked for libera.chat unless --insecure-plain."
+    },
+    {
+      "flag": "--insecure-plain",
+      "meaning": "Allow plaintext even for Libera hostnames."
+    },
+    {
+      "flag": "--nick",
+      "meaning": "Nickname (else ~/.irc/config.json, BARE_IRC_NICK, USER)."
+    },
+    {
+      "flag": "--sasl-user",
+      "meaning": "SASL PLAIN account. Password from ~/.irc/secrets.json."
+    }
+  ],
+  "keywords": ["irc", "libera", "tui", "chat"],
+  "bareOsNotes": "Needs ctx.bareOsTlsConnect (ctx API 1.57.0). Disable with BARE_OS_IRC=0."
+}