agentirc-cli 4.5.2__tar.gz → 5.0.1__tar.gz

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/CHANGELOG.md

@@ -4,17 +4,55 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [5.0.1] - 2026-04-09
+
+
+### Added
+
+- Topic subcommand for IRC skill (#192)
+- @mention validation warnings for unknown nicks (#196)
+- GitHub issues skill for Claude Code
+
+
+### Fixed
+
+- Whitespace-only messages now rejected (#195)
+- join/part channel state desync with # prefix validation (#194)
+- Sending to unjoined channels now returns error (#193)
+- Agents can now read own messages in channel history (#191)
+- Codex backend meta-response stripping (#197)
+
+## [5.0.0] - 2026-04-09
+
+
+### Added
+
+- Mesh overview shows stopped/registered agents from server.yaml manifest (#178)
+
+
+### Changed
+
+- CLI docs use correct noun-group syntax (culture agent create, culture channel read, etc.) (#186)
+- Replaced non-existent culture send with culture channel message / culture agent message (#187)
+- All doc references updated from agents.yaml to server.yaml (#188)
+- Documented --mesh-config, --webhook-port, --data-dir server start flags (#189)
+
+
+### Fixed
+
+- Mesh overview now includes agents that are registered but not running
+
 ## [4.5.2] - 2026-04-09
 
 
 ### Fixed
 
-- Agent status shows running when circuit breaker is open (#179)
-- Agent status list does not distinguish paused/sleeping agents (#180)
-- Learn prompt missing compact/clear commands and ask --timeout (#181)
-- Non-Claude backend skill docs missing features - all-backends rule violation (#182)
-- Admin skill and learn prompt missing many CLI commands (#183)
-- Mesh overview shows archived bots without archive indication (#184)
+- Agent status now reports the circuit-open state correctly instead of showing running (#179)
+- Agent status list now distinguishes paused and sleeping agents correctly (#180)
+- Learn prompt now includes compact/clear commands and ask --timeout (#181)
+- Non-Claude backend skill docs now include the required features and comply with the all-backends rule (#182)
+- Admin skill and learn prompt now include the missing CLI commands (#183)
+- Mesh overview now indicates when bots are archived (#184)
 
 ## [4.5.1] - 2026-04-09
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.5.2
+Version: 5.0.1
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/cli/mesh.py

@@ -120,7 +120,13 @@ def dispatch(args: argparse.Namespace) -> None:
 # -----------------------------------------------------------------------
 
 
-def _collect_mesh_data(host: str, port: int, server_name: str, message_limit: int):
+def _collect_mesh_data(
+    host: str,
+    port: int,
+    server_name: str,
+    message_limit: int,
+    manifest_agents: list | None = None,
+):
     """Collect mesh state, exiting with an error message on connection failure."""
     from culture.overview.collector import collect_mesh_state
 
@@ -131,6 +137,7 @@ def _collect_mesh_data(host: str, port: int, server_name: str, message_limit: in
                 port=port,
                 server_name=server_name,
                 message_limit=message_limit,
+                manifest_agents=manifest_agents,
             )
         )
     except ConnectionRefusedError:
@@ -169,11 +176,16 @@ def _cmd_overview(args: argparse.Namespace) -> None:
             agent_filter=args.agent,
             message_limit=message_limit,
             refresh_interval=refresh_interval,
+            manifest_agents=config.agents,
         )
         return
 
     mesh = _collect_mesh_data(
-        config.server.host, config.server.port, config.server.name, message_limit
+        config.server.host,
+        config.server.port,
+        config.server.name,
+        message_limit,
+        manifest_agents=config.agents,
     )
     output = render_text(
         mesh,

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/acp/daemon.py

@@ -35,6 +35,9 @@ _ERR_MISSING_CHANNEL = "Missing 'channel'"
 _ERR_MISSING_CHANNEL_THREAD = "Missing 'channel' or 'thread'"
 _ERR_MISSING_CHANNEL_THREAD_MSG = "Missing 'channel', 'thread', or 'message'"
 
+# Regex to extract @mentioned nicks from messages
+_MENTION_RE = re.compile(r"@([\w-]+)")
+
 MAX_CRASH_COUNT = 3
 CRASH_WINDOW_SECONDS = 300
 CRASH_RESTART_DELAY = 5
@@ -103,6 +106,7 @@ class ACPDaemon:
             "irc_part": self._ipc_irc_part,
             "irc_channels": self._ipc_irc_channels,
             "irc_who": self._ipc_irc_who,
+            "irc_topic": self._ipc_irc_topic,
             "irc_ask": self._ipc_irc_ask,
             "compact": self._ipc_compact,
             "clear": self._ipc_clear,
@@ -749,16 +753,34 @@ class ACPDaemon:
             self._status_query_event = None
             self._status_query_response = ""
 
+    def _check_mention_warnings(self, text: str) -> list[str]:
+        """Return warnings for @mentioned nicks not seen in any buffer."""
+        mentions = _MENTION_RE.findall(text)
+        if not mentions or not self._buffer:
+            return []
+        known_nicks = self._buffer.known_nicks()
+        warnings = []
+        for nick in mentions:
+            if nick not in known_nicks:
+                warnings.append(f"Mentioned nick not found: {nick}")
+        return warnings
+
     async def _ipc_irc_send(self, req_id: str, msg: dict) -> dict:
         channel = msg.get("channel", "")
         text = msg.get("message", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
-        if not text:
+        if not text or not text.strip():
             return make_response(req_id, ok=False, error="Missing 'message'")
         assert self._transport is not None
+        if channel.startswith("#") and channel not in self._transport.channels:
+            return make_response(req_id, ok=False, error=f"Not joined to {channel}")
         await self._transport.send_privmsg(channel, text)
-        return make_response(req_id, ok=True)
+        warnings = self._check_mention_warnings(text)
+        resp = make_response(req_id, ok=True)
+        if warnings:
+            resp["warnings"] = warnings
+        return resp
 
     def _ipc_irc_read(self, req_id: str, msg: dict) -> dict:
         channel = msg.get("channel", "")
@@ -781,6 +803,8 @@ class ACPDaemon:
         channel = msg.get("channel", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
         assert self._transport is not None
         await self._transport.join_channel(channel)
         return make_response(req_id, ok=True)
@@ -789,6 +813,8 @@ class ACPDaemon:
         channel = msg.get("channel", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
         assert self._transport is not None
         await self._transport.part_channel(channel)
         return make_response(req_id, ok=True)
@@ -862,13 +888,24 @@ class ACPDaemon:
         await self._transport.send_who(target)
         return make_response(req_id, ok=True)
 
+    async def _ipc_irc_topic(self, req_id: str, msg: dict) -> dict:
+        channel = msg.get("channel", "")
+        if not channel:
+            return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
+        assert self._transport is not None
+        topic = msg.get("topic")  # None means query, string means set
+        await self._transport.send_topic(channel, topic)
+        return make_response(req_id, ok=True)
+
     async def _ipc_irc_ask(self, req_id: str, msg: dict) -> dict:
         """Send a PRIVMSG and fire a question webhook. Response matching is TODO."""
         channel = msg.get("channel", "")
         question = msg.get("message", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
-        if not question:
+        if not question or not question.strip():
             return make_response(req_id, ok=False, error="Missing 'message'")
         assert self._transport is not None
         await self._transport.send_privmsg(channel, question)

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/acp/irc_transport.py

@@ -51,6 +51,9 @@ class IRCTransport:
             "PRIVMSG": self._on_privmsg,
             "NOTICE": self._on_notice,
             "ROOMINVITE": self._on_roominvite,
+            "TOPIC": self._on_topic,
+            "331": self._on_numeric_topic,
+            "332": self._on_numeric_topic,
         }
 
     async def connect(self) -> None:
@@ -90,6 +93,10 @@ class IRCTransport:
         for line in text.splitlines():
             if line:
                 await self._send_raw(f"PRIVMSG {target} :{line}")
+                if target.startswith("#"):
+                    self.buffer.add(target, self.nick, line)
+                else:
+                    self.buffer.add(f"DM:{target}", self.nick, line)
 
     async def send_thread_create(self, channel: str, thread_name: str, text: str) -> None:
         lines = [l for l in text.splitlines() if l]
@@ -112,11 +119,15 @@ class IRCTransport:
         await self._send_raw(f"THREADS {channel}")
 
     async def join_channel(self, channel: str) -> None:
+        if not channel.startswith("#"):
+            return
         await self._send_raw(f"JOIN {channel}")
         if channel not in self.channels:
             self.channels.append(channel)
 
     async def part_channel(self, channel: str) -> None:
+        if not channel.startswith("#"):
+            return
         await self._send_raw(f"PART {channel}")
         if channel in self.channels:
             self.channels.remove(channel)
@@ -124,6 +135,12 @@ class IRCTransport:
     async def send_who(self, target: str) -> None:
         await self._send_raw(f"WHO {target}")
 
+    async def send_topic(self, channel: str, topic: str | None = None) -> None:
+        if topic is not None:
+            await self._send_raw(f"TOPIC {channel} :{topic}")
+        else:
+            await self._send_raw(f"TOPIC {channel}")
+
     async def send_raw(self, line: str) -> None:
         """Send a raw IRC line. Public for commands like HISTORY."""
         if self._writer:
@@ -202,6 +219,28 @@ class IRCTransport:
         self._route_to_buffer(target, sender, text)
         self._detect_and_fire_mention(target, sender, text)
 
+    def _on_topic(self, msg: Message) -> None:
+        """Handle TOPIC broadcasts (someone changed the topic)."""
+        if len(msg.params) < 2:
+            return
+        channel = msg.params[0]
+        topic = msg.params[1]
+        sender = msg.prefix.split("!")[0] if msg.prefix else "server"
+        if channel.startswith("#"):
+            self.buffer.add(channel, sender, f"* Topic changed: {topic}")
+
+    def _on_numeric_topic(self, msg: Message) -> None:
+        """Handle 331 (no topic) and 332 (topic is...) replies."""
+        if len(msg.params) < 2:
+            return
+        channel = msg.params[1]
+        if not channel.startswith("#"):
+            return
+        if msg.command == "331":
+            self.buffer.add(channel, "server", "* No topic is set")
+        elif msg.command == "332" and len(msg.params) >= 3:
+            self.buffer.add(channel, "server", f"* Topic: {msg.params[2]}")
+
     def _route_to_buffer(self, target: str, sender: str, text: str) -> None:
         """Insert the message into the appropriate buffer (channel or DM)."""
         if target.startswith("#"):

{agentirc_cli-4.5.2/culture/clients/codex → agentirc_cli-5.0.1/culture/clients/acp}/message_buffer.py

@@ -53,6 +53,14 @@ class MessageBuffer:
         self._cursors[channel] = total
         return new_messages
 
+    def known_nicks(self) -> set[str]:
+        """Return the set of nicks seen across all buffers."""
+        nicks: set[str] = set()
+        for buf in self._buffers.values():
+            for m in buf:
+                nicks.add(m.nick)
+        return nicks
+
     def read_thread(self, channel: str, thread_name: str, limit: int = 50) -> list[BufferedMessage]:
         buf = self._buffers.get(channel)
         if not buf:

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/acp/skill/SKILL.md

@@ -141,6 +141,26 @@ python3 -m culture.clients.acp.skill.irc_client who <target>
 
 ---
 
+### topic — get or set a channel topic
+
+```bash
+python3 -m culture.clients.acp.skill.irc_client topic <channel> [topic text]
+```
+
+Get current topic:
+
+```bash
+python3 -m culture.clients.acp.skill.irc_client topic "#general"
+```
+
+Set topic:
+
+```bash
+python3 -m culture.clients.acp.skill.irc_client topic "#general" "Welcome to general chat"
+```
+
+---
+
 ### compact — compact the agent's context window
 
 ```bash
@@ -190,6 +210,8 @@ result = await client.irc_join("#ops")
 result = await client.irc_part("#ops")
 result = await client.irc_channels()
 result = await client.irc_who("#general")
+result = await client.irc_topic("#general")
+result = await client.irc_topic("#general", "Welcome to general chat")
 result = await client.compact()
 result = await client.clear()
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/acp/skill/irc_client.py

@@ -165,6 +165,13 @@ class SkillClient:
         """Send a WHO query for a channel or nick."""
         return await self._request("irc_who", target=target)
 
+    async def irc_topic(self, channel: str, topic: str | None = None) -> dict[str, Any]:
+        """Get or set a channel topic."""
+        params: dict[str, Any] = {"channel": channel}
+        if topic is not None:
+            params["topic"] = topic
+        return await self._request("irc_topic", **params)
+
     async def compact(self) -> dict[str, Any]:
         """Send /compact to the agent runner."""
         return await self._request("compact")
@@ -248,6 +255,12 @@ async def _cmd_who(client: SkillClient, args: list[str]) -> dict[str, Any]:
     return await client.irc_who(args[1])
 
 
+async def _cmd_topic(client: SkillClient, args: list[str]) -> dict[str, Any]:
+    channel = args[1]
+    topic = " ".join(args[2:]) if len(args) > 2 else None
+    return await client.irc_topic(channel, topic)
+
+
 async def _cmd_compact(client: SkillClient, args: list[str]) -> dict[str, Any]:
     return await client.compact()
 
@@ -264,6 +277,7 @@ _SUBCOMMANDS: dict[str, Any] = {
     "part": _cmd_part,
     "channels": _cmd_channels,
     "who": _cmd_who,
+    "topic": _cmd_topic,
     "compact": _cmd_compact,
     "clear": _cmd_clear,
 }
@@ -274,7 +288,7 @@ async def _main(args: list[str]) -> None:
     if not args:
         print(
             "Usage: irc_client.py <subcommand> [args...]\n"
-            "Subcommands: send, read, ask, join, part, channels, who, compact, clear",
+            "Subcommands: send, read, ask, join, part, channels, who, topic, compact, clear",
             file=sys.stderr,
         )
         sys.exit(1)

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/claude/daemon.py

@@ -29,6 +29,9 @@ _ERR_MISSING_CHANNEL = "Missing 'channel'"
 _ERR_MISSING_CHANNEL_THREAD = "Missing 'channel' or 'thread'"
 _ERR_MISSING_CHANNEL_THREAD_MSG = "Missing 'channel', 'thread', or 'message'"
 
+# Regex to extract @mentioned nicks from messages
+_MENTION_RE = re.compile(r"@([\w-]+)")
+
 
 class AgentDaemon:
     """Central orchestrator that ties together the IRC transport, socket server,
@@ -86,6 +89,7 @@ class AgentDaemon:
             "irc_part": self._ipc_irc_part,
             "irc_channels": self._ipc_irc_channels,
             "irc_who": self._ipc_irc_who,
+            "irc_topic": self._ipc_irc_topic,
             "irc_ask": self._ipc_irc_ask,
             "compact": self._ipc_compact,
             "clear": self._ipc_clear,
@@ -639,16 +643,34 @@ class AgentDaemon:
             self._status_query_event = None
             self._status_query_response = ""
 
+    def _check_mention_warnings(self, text: str) -> list[str]:
+        """Return warnings for @mentioned nicks not seen in any buffer."""
+        mentions = _MENTION_RE.findall(text)
+        if not mentions or not self._buffer:
+            return []
+        known_nicks = self._buffer.known_nicks()
+        warnings = []
+        for nick in mentions:
+            if nick not in known_nicks:
+                warnings.append(f"Mentioned nick not found: {nick}")
+        return warnings
+
     async def _ipc_irc_send(self, req_id: str, msg: dict) -> dict:
         channel = msg.get("channel", "")
         text = msg.get("message", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
-        if not text:
+        if not text or not text.strip():
             return make_response(req_id, ok=False, error="Missing 'message'")
         assert self._transport is not None
+        if channel.startswith("#") and channel not in self._transport.channels:
+            return make_response(req_id, ok=False, error=f"Not joined to {channel}")
         await self._transport.send_privmsg(channel, text)
-        return make_response(req_id, ok=True)
+        warnings = self._check_mention_warnings(text)
+        resp = make_response(req_id, ok=True)
+        if warnings:
+            resp["warnings"] = warnings
+        return resp
 
     def _ipc_irc_read(self, req_id: str, msg: dict) -> dict:
         channel = msg.get("channel", "")
@@ -671,6 +693,8 @@ class AgentDaemon:
         channel = msg.get("channel", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
         assert self._transport is not None
         await self._transport.join_channel(channel)
         return make_response(req_id, ok=True)
@@ -679,6 +703,8 @@ class AgentDaemon:
         channel = msg.get("channel", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
         assert self._transport is not None
         await self._transport.part_channel(channel)
         return make_response(req_id, ok=True)
@@ -752,13 +778,24 @@ class AgentDaemon:
         await self._transport.send_who(target)
         return make_response(req_id, ok=True)
 
+    async def _ipc_irc_topic(self, req_id: str, msg: dict) -> dict:
+        channel = msg.get("channel", "")
+        if not channel:
+            return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
+        if not channel.startswith("#"):
+            return make_response(req_id, ok=False, error="Channel name must start with '#'")
+        assert self._transport is not None
+        topic = msg.get("topic")  # None means query, string means set
+        await self._transport.send_topic(channel, topic)
+        return make_response(req_id, ok=True)
+
     async def _ipc_irc_ask(self, req_id: str, msg: dict) -> dict:
         """Send a PRIVMSG and fire a question webhook. Response matching is TODO."""
         channel = msg.get("channel", "")
         question = msg.get("message", "")
         if not channel:
             return make_response(req_id, ok=False, error=_ERR_MISSING_CHANNEL)
-        if not question:
+        if not question or not question.strip():
             return make_response(req_id, ok=False, error="Missing 'message'")
         assert self._transport is not None
         await self._transport.send_privmsg(channel, question)

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/claude/irc_transport.py

@@ -51,6 +51,9 @@ class IRCTransport:
             "PRIVMSG": self._on_privmsg,
             "NOTICE": self._on_notice,
             "ROOMINVITE": self._on_roominvite,
+            "TOPIC": self._on_topic,
+            "331": self._on_numeric_topic,
+            "332": self._on_numeric_topic,
         }
 
     async def connect(self) -> None:
@@ -90,6 +93,10 @@ class IRCTransport:
         for line in text.splitlines():
             if line:
                 await self._send_raw(f"PRIVMSG {target} :{line}")
+                if target.startswith("#"):
+                    self.buffer.add(target, self.nick, line)
+                else:
+                    self.buffer.add(f"DM:{target}", self.nick, line)
 
     async def send_thread_create(self, channel: str, thread_name: str, text: str) -> None:
         lines = [l for l in text.splitlines() if l]
@@ -112,11 +119,15 @@ class IRCTransport:
         await self._send_raw(f"THREADS {channel}")
 
     async def join_channel(self, channel: str) -> None:
+        if not channel.startswith("#"):
+            return
         await self._send_raw(f"JOIN {channel}")
         if channel not in self.channels:
             self.channels.append(channel)
 
     async def part_channel(self, channel: str) -> None:
+        if not channel.startswith("#"):
+            return
         await self._send_raw(f"PART {channel}")
         if channel in self.channels:
             self.channels.remove(channel)
@@ -124,6 +135,12 @@ class IRCTransport:
     async def send_who(self, target: str) -> None:
         await self._send_raw(f"WHO {target}")
 
+    async def send_topic(self, channel: str, topic: str | None = None) -> None:
+        if topic is not None:
+            await self._send_raw(f"TOPIC {channel} :{topic}")
+        else:
+            await self._send_raw(f"TOPIC {channel}")
+
     async def send_raw(self, line: str) -> None:
         """Send a raw IRC line. Public for commands like HISTORY."""
         if self._writer:
@@ -202,6 +219,28 @@ class IRCTransport:
         self._route_to_buffer(target, sender, text)
         self._detect_and_fire_mention(target, sender, text)
 
+    def _on_topic(self, msg: Message) -> None:
+        """Handle TOPIC broadcasts (someone changed the topic)."""
+        if len(msg.params) < 2:
+            return
+        channel = msg.params[0]
+        topic = msg.params[1]
+        sender = msg.prefix.split("!")[0] if msg.prefix else "server"
+        if channel.startswith("#"):
+            self.buffer.add(channel, sender, f"* Topic changed: {topic}")
+
+    def _on_numeric_topic(self, msg: Message) -> None:
+        """Handle 331 (no topic) and 332 (topic is...) replies."""
+        if len(msg.params) < 2:
+            return
+        channel = msg.params[1]
+        if not channel.startswith("#"):
+            return
+        if msg.command == "331":
+            self.buffer.add(channel, "server", "* No topic is set")
+        elif msg.command == "332" and len(msg.params) >= 3:
+            self.buffer.add(channel, "server", f"* Topic: {msg.params[2]}")
+
     def _route_to_buffer(self, target: str, sender: str, text: str) -> None:
         """Insert the message into the appropriate buffer (channel or DM)."""
         if target.startswith("#"):

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/claude/message_buffer.py

@@ -53,6 +53,14 @@ class MessageBuffer:
         self._cursors[channel] = total
         return new_messages
 
+    def known_nicks(self) -> set[str]:
+        """Return the set of nicks seen across all buffers."""
+        nicks: set[str] = set()
+        for buf in self._buffers.values():
+            for m in buf:
+                nicks.add(m.nick)
+        return nicks
+
     def read_thread(self, channel: str, thread_name: str, limit: int = 50) -> list[BufferedMessage]:
         buf = self._buffers.get(channel)
         if not buf:

{agentirc_cli-4.5.2/plugins/claude-code/skills/irc → agentirc_cli-5.0.1/culture/clients/claude/skill}/SKILL.md

@@ -134,6 +134,26 @@ python3 -m culture.clients.claude.skill.irc_client who <target>
 
 ---
 
+### topic — get or set a channel topic
+
+```bash
+python3 -m culture.clients.claude.skill.irc_client topic <channel> [topic text]
+```
+
+Get current topic:
+
+```bash
+python3 -m culture.clients.claude.skill.irc_client topic "#general"
+```
+
+Set topic:
+
+```bash
+python3 -m culture.clients.claude.skill.irc_client topic "#general" "Welcome to general chat"
+```
+
+---
+
 ### compact — compact the agent's context window
 
 ```bash
@@ -183,6 +203,8 @@ result = await client.irc_join("#ops")
 result = await client.irc_part("#ops")
 result = await client.irc_channels()
 result = await client.irc_who("#general")
+result = await client.irc_topic("#general")
+result = await client.irc_topic("#general", "Welcome to general chat")
 result = await client.compact()
 result = await client.clear()
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.1}/culture/clients/claude/skill/irc_client.py

@@ -162,6 +162,13 @@ class SkillClient:
         """Send a WHO query for a channel or nick."""
         return await self._request("irc_who", target=target)
 
+    async def irc_topic(self, channel: str, topic: str | None = None) -> dict[str, Any]:
+        """Get or set a channel topic."""
+        params: dict[str, Any] = {"channel": channel}
+        if topic is not None:
+            params["topic"] = topic
+        return await self._request("irc_topic", **params)
+
     async def compact(self) -> dict[str, Any]:
         """Send /compact to the Claude agent runner."""
         return await self._request("compact")
@@ -245,6 +252,12 @@ async def _cmd_who(client: SkillClient, args: list[str]) -> dict[str, Any]:
     return await client.irc_who(args[1])
 
 
+async def _cmd_topic(client: SkillClient, args: list[str]) -> dict[str, Any]:
+    channel = args[1]
+    topic = " ".join(args[2:]) if len(args) > 2 else None
+    return await client.irc_topic(channel, topic)
+
+
 async def _cmd_compact(client: SkillClient, args: list[str]) -> dict[str, Any]:
     return await client.compact()
 
@@ -261,6 +274,7 @@ _SUBCOMMANDS: dict[str, Any] = {
     "part": _cmd_part,
     "channels": _cmd_channels,
     "who": _cmd_who,
+    "topic": _cmd_topic,
     "compact": _cmd_compact,
     "clear": _cmd_clear,
 }
@@ -271,7 +285,7 @@ async def _main(args: list[str]) -> None:
     if not args:
         print(
             "Usage: irc_client.py <subcommand> [args...]\n"
-            "Subcommands: send, read, ask, join, part, channels, who, compact, clear",
+            "Subcommands: send, read, ask, join, part, channels, who, topic, compact, clear",
             file=sys.stderr,
         )
         sys.exit(1)