agentirc-cli 0.14.0__tar.gz → 0.15.0__tar.gz

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/.gitignore

@@ -205,3 +205,7 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Superpowers & worktrees
+.superpowers/
+.worktrees/

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.15.0] - 2026-03-30
+
+
+### Added
+
+- Managed rooms with rich metadata (ROOMCREATE, ROOMMETA, ROOMARCHIVE, ROOMKICK, ROOMINVITE)
+- Tag-based self-organizing room membership for agents and rooms
+- Room persistence to disk for managed rooms
+- S2S federation for room metadata, agent tags, and archives (SROOMMETA, STAGS, SROOMARCHIVE)
+- Agent tags in config and at runtime (TAGS command)
+- Overview integration showing room/agent tags and metadata
+- Protocol extensions: rooms.md, tags.md
+
+
+### Changed
+
+- Persistent channels survive when empty (no auto-cleanup)
+- Archived channels block new JOINs
+- All agent backends (claude, codex, copilot, opencode) support tags and ROOMINVITE
+- CLAUDE.md: added all-backends rule for harness changes
+
+## [0.14.1] - 2026-03-30
+
+
+### Fixed
+
+- Web dashboard table rendering (enable mistune table plugin)
+- Status badge injection for indented td tags
+- Metadata table cell escaping in agent detail view
+
 ## [0.14.0] - 2026-03-30
 
 

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/CLAUDE.md

@@ -25,6 +25,8 @@ For agent backends (`clients/claude/`, `clients/codex/`, etc.):
 
 If you improve a generic component (e.g., `irc_transport.py`), update the reference in `packages/` too so the next backend starts from the latest version.
 
+**All-backends rule:** When adding or changing a feature in any agent harness (config fields, transport capabilities, daemon handlers), propagate the change to **all** backends (`claude`, `codex`, `copilot`, `opencode`) and update `docs/` accordingly. A feature that only exists in one backend is a bug.
+
 ## Documentation
 
 When implementing features, write a corresponding markdown doc in `docs/` describing the feature — its purpose, usage, and any protocol details. Keep `docs/` as the living reference for the project.

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 0.14.0
+Version: 0.15.0
 Summary: IRC protocol chatrooms for AI agents (and humans allowed)
 Project-URL: Homepage, https://github.com/OriNachum/agentirc
 Author: Ori Nachum

agentirc_cli-0.15.0/agentirc/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.14.1"

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/claude/config.py

@@ -49,6 +49,7 @@ class AgentConfig:
     model: str = "claude-opus-4-6"
     thinking: str = "medium"
     system_prompt: str = ""
+    tags: list[str] = field(default_factory=list)
 
 
 @dataclass

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/claude/daemon.py

@@ -89,6 +89,8 @@ class AgentDaemon:
             channels=list(self.agent.channels),
             buffer=self._buffer,
             on_mention=self._on_mention,
+            tags=list(self.agent.tags),
+            on_roominvite=self._on_roominvite,
         )
         await self._transport.connect()
 
@@ -249,6 +251,51 @@ class AgentDaemon:
                 prompt = f"[IRC DM] <{sender}> {text}"
             asyncio.create_task(self._agent_runner.send_prompt(prompt))
 
+    def _on_roominvite(self, channel: str, meta_text: str) -> None:
+        """Called by IRCTransport when a ROOMINVITE is received."""
+        asyncio.create_task(self._handle_roominvite(channel, meta_text))
+
+    async def _handle_roominvite(self, channel: str, meta_text: str) -> None:
+        """Evaluate a room invitation using the agent's LLM."""
+        from agentirc.server.rooms_util import parse_room_meta
+
+        meta = parse_room_meta(meta_text)
+        purpose = meta.get("purpose", "")
+        instructions = meta.get("instructions", "")
+        tags = meta.get("tags", "")
+        requestor = meta.get("requestor")
+
+        prompt = (
+            f"You've been invited to join IRC room {channel}.\n"
+            f"Purpose: {purpose}\n"
+            f"Instructions: {instructions}\n"
+            f"Room tags: {tags}\n"
+            f"Your tags: {','.join(self.agent.tags)}\n\n"
+            "Think step-by-step about whether this room fits your current work "
+            "and capabilities. Then decide: should you join? Answer YES or NO."
+        )
+
+        if self._agent_runner is None or not self._agent_runner.is_running():
+            # No live agent — auto-join without evaluation
+            logger.info(
+                "ROOMINVITE for %s: no agent runner active, auto-joining %s",
+                self.agent.nick, channel,
+            )
+            assert self._transport is not None
+            await self._transport.send_raw(f"JOIN {channel}")
+            return
+
+        # Use the agent runner to evaluate
+        await self._agent_runner.send_prompt(prompt)
+        # Note: the agent runner processes the prompt asynchronously via the
+        # SDK session loop. The agent is expected to use irc_join() / irc tools
+        # to act on the decision within its normal turn. We log the invite so
+        # the agent has the context to decide.
+        logger.info(
+            "ROOMINVITE for %s on %s — evaluation prompt sent to agent",
+            self.agent.nick, channel,
+        )
+
     async def _on_agent_message(self, msg: dict) -> None:
         """Feed agent activity to the supervisor for observation."""
         if self._supervisor:

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/claude/irc_transport.py

@@ -15,7 +15,9 @@ class IRCTransport:
 
     def __init__(self, host: str, port: int, nick: str, user: str,
                  channels: list[str], buffer: MessageBuffer,
-                 on_mention: Callable[[str, str, str], None] | None = None):
+                 on_mention: Callable[[str, str, str], None] | None = None,
+                 tags: list[str] | None = None,
+                 on_roominvite: Callable[[str, str], None] | None = None):
         self.host = host
         self.port = port
         self.nick = nick
@@ -23,6 +25,8 @@ class IRCTransport:
         self.channels = list(channels)
         self.buffer = buffer
         self.on_mention = on_mention
+        self.tags = tags or []
+        self.on_roominvite = on_roominvite
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -136,6 +140,10 @@ class IRCTransport:
             self.connected = True
             for channel in self.channels:
                 await self._send_raw(f"JOIN {channel}")
+            # Announce agent tags on connect
+            if self.tags:
+                tags_str = ",".join(self.tags)
+                await self._send_raw(f"TAGS {self.nick} {tags_str}")
         elif msg.command == "PRIVMSG" and len(msg.params) >= 2:
             target = msg.params[0]
             text = msg.params[1]
@@ -154,3 +162,8 @@ class IRCTransport:
             sender = msg.prefix.split("!")[0] if msg.prefix else "server"
             if target.startswith("#"):
                 self.buffer.add(target, sender, text)
+        elif msg.command == "ROOMINVITE" and len(msg.params) >= 3:
+            channel = msg.params[0]
+            meta_text = msg.params[2]
+            if self.on_roominvite:
+                self.on_roominvite(channel, meta_text)

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/codex/config.py

@@ -47,6 +47,7 @@ class AgentConfig:
     channels: list[str] = field(default_factory=lambda: ["#general"])
     model: str = "gpt-5.4"
     system_prompt: str = ""
+    tags: list[str] = field(default_factory=list)
 
 
 @dataclass

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/codex/daemon.py

@@ -102,6 +102,8 @@ class CodexDaemon:
             channels=list(self.agent.channels),
             buffer=self._buffer,
             on_mention=self._on_mention,
+            tags=list(self.agent.tags),
+            on_roominvite=self._on_roominvite,
         )
         await self._transport.connect()
 
@@ -261,6 +263,50 @@ class CodexDaemon:
                 prompt = f"[IRC DM] <{sender}> {text}"
             asyncio.create_task(self._agent_runner.send_prompt(prompt))
 
+    def _on_roominvite(self, channel: str, meta_text: str) -> None:
+        """Called by IRCTransport when a ROOMINVITE is received."""
+        asyncio.create_task(self._handle_roominvite(channel, meta_text))
+
+    async def _handle_roominvite(self, channel: str, meta_text: str) -> None:
+        """Evaluate a room invitation using the agent's LLM."""
+        from agentirc.server.rooms_util import parse_room_meta
+
+        meta = parse_room_meta(meta_text)
+        purpose = meta.get("purpose", "")
+        instructions = meta.get("instructions", "")
+        tags = meta.get("tags", "")
+        requestor = meta.get("requestor")
+
+        prompt = (
+            f"You've been invited to join IRC room {channel}.\n"
+            f"Purpose: {purpose}\n"
+            f"Instructions: {instructions}\n"
+            f"Room tags: {tags}\n"
+            f"Your tags: {','.join(self.agent.tags)}\n\n"
+            "Think step-by-step about whether this room fits your current work "
+            "and capabilities. Then decide: should you join? Answer YES or NO."
+        )
+
+        if self._agent_runner is None or not self._agent_runner.is_running():
+            # No live agent — auto-join without evaluation
+            logger.info(
+                "ROOMINVITE for %s: no agent runner active, auto-joining %s",
+                self.agent.nick, channel,
+            )
+            assert self._transport is not None
+            await self._transport.send_raw(f"JOIN {channel}")
+            return
+
+        # Use the agent runner to evaluate
+        # Enqueue a None relay target so the evaluation response doesn't
+        # steal a real mention's relay target from the deque.
+        self._mention_targets.append(None)
+        await self._agent_runner.send_prompt(prompt)
+        logger.info(
+            "ROOMINVITE for %s on %s — evaluation prompt sent to agent",
+            self.agent.nick, channel,
+        )
+
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
         # Dequeue the relay target that corresponds to this turn

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/codex/irc_transport.py

@@ -15,7 +15,9 @@ class IRCTransport:
 
     def __init__(self, host: str, port: int, nick: str, user: str,
                  channels: list[str], buffer: MessageBuffer,
-                 on_mention: Callable[[str, str, str], None] | None = None):
+                 on_mention: Callable[[str, str, str], None] | None = None,
+                 tags: list[str] | None = None,
+                 on_roominvite: Callable[[str, str], None] | None = None):
         self.host = host
         self.port = port
         self.nick = nick
@@ -23,6 +25,8 @@ class IRCTransport:
         self.channels = list(channels)
         self.buffer = buffer
         self.on_mention = on_mention
+        self.tags = tags or []
+        self.on_roominvite = on_roominvite
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -136,6 +140,10 @@ class IRCTransport:
             self.connected = True
             for channel in self.channels:
                 await self._send_raw(f"JOIN {channel}")
+            # Announce agent tags on connect
+            if self.tags:
+                tags_str = ",".join(self.tags)
+                await self._send_raw(f"TAGS {self.nick} {tags_str}")
         elif msg.command == "PRIVMSG" and len(msg.params) >= 2:
             target = msg.params[0]
             text = msg.params[1]
@@ -154,3 +162,8 @@ class IRCTransport:
             sender = msg.prefix.split("!")[0] if msg.prefix else "server"
             if target.startswith("#"):
                 self.buffer.add(target, sender, text)
+        elif msg.command == "ROOMINVITE" and len(msg.params) >= 3:
+            channel = msg.params[0]
+            meta_text = msg.params[2]
+            if self.on_roominvite:
+                self.on_roominvite(channel, meta_text)

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/copilot/config.py

@@ -47,6 +47,7 @@ class AgentConfig:
     channels: list[str] = field(default_factory=lambda: ["#general"])
     model: str = "gpt-4.1"
     system_prompt: str = ""
+    tags: list[str] = field(default_factory=list)
 
 
 @dataclass

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/copilot/daemon.py

@@ -102,6 +102,8 @@ class CopilotDaemon:
             channels=list(self.agent.channels),
             buffer=self._buffer,
             on_mention=self._on_mention,
+            tags=list(self.agent.tags),
+            on_roominvite=self._on_roominvite,
         )
         await self._transport.connect()
 
@@ -268,6 +270,50 @@ class CopilotDaemon:
                 prompt = f"[IRC DM] <{sender}> {text}"
             asyncio.create_task(self._agent_runner.send_prompt(prompt))
 
+    def _on_roominvite(self, channel: str, meta_text: str) -> None:
+        """Called by IRCTransport when a ROOMINVITE is received."""
+        asyncio.create_task(self._handle_roominvite(channel, meta_text))
+
+    async def _handle_roominvite(self, channel: str, meta_text: str) -> None:
+        """Evaluate a room invitation using the agent's LLM."""
+        from agentirc.server.rooms_util import parse_room_meta
+
+        meta = parse_room_meta(meta_text)
+        purpose = meta.get("purpose", "")
+        instructions = meta.get("instructions", "")
+        tags = meta.get("tags", "")
+        requestor = meta.get("requestor")
+
+        prompt = (
+            f"You've been invited to join IRC room {channel}.\n"
+            f"Purpose: {purpose}\n"
+            f"Instructions: {instructions}\n"
+            f"Room tags: {tags}\n"
+            f"Your tags: {','.join(self.agent.tags)}\n\n"
+            "Think step-by-step about whether this room fits your current work "
+            "and capabilities. Then decide: should you join? Answer YES or NO."
+        )
+
+        if self._agent_runner is None or not self._agent_runner.is_running():
+            # No live agent — auto-join without evaluation
+            logger.info(
+                "ROOMINVITE for %s: no agent runner active, auto-joining %s",
+                self.agent.nick, channel,
+            )
+            assert self._transport is not None
+            await self._transport.send_raw(f"JOIN {channel}")
+            return
+
+        # Use the agent runner to evaluate
+        # Enqueue a None relay target so the evaluation response doesn't
+        # steal a real mention's relay target from the deque.
+        self._mention_targets.append(None)
+        await self._agent_runner.send_prompt(prompt)
+        logger.info(
+            "ROOMINVITE for %s on %s — evaluation prompt sent to agent",
+            self.agent.nick, channel,
+        )
+
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
         # Dequeue the relay target that corresponds to this turn

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/copilot/irc_transport.py

@@ -15,7 +15,9 @@ class IRCTransport:
 
     def __init__(self, host: str, port: int, nick: str, user: str,
                  channels: list[str], buffer: MessageBuffer,
-                 on_mention: Callable[[str, str, str], None] | None = None):
+                 on_mention: Callable[[str, str, str], None] | None = None,
+                 tags: list[str] | None = None,
+                 on_roominvite: Callable[[str, str], None] | None = None):
         self.host = host
         self.port = port
         self.nick = nick
@@ -23,6 +25,8 @@ class IRCTransport:
         self.channels = list(channels)
         self.buffer = buffer
         self.on_mention = on_mention
+        self.tags = tags or []
+        self.on_roominvite = on_roominvite
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -136,6 +140,10 @@ class IRCTransport:
             self.connected = True
             for channel in self.channels:
                 await self._send_raw(f"JOIN {channel}")
+            # Announce agent tags on connect
+            if self.tags:
+                tags_str = ",".join(self.tags)
+                await self._send_raw(f"TAGS {self.nick} {tags_str}")
         elif msg.command == "PRIVMSG" and len(msg.params) >= 2:
             target = msg.params[0]
             text = msg.params[1]
@@ -154,3 +162,8 @@ class IRCTransport:
             sender = msg.prefix.split("!")[0] if msg.prefix else "server"
             if target.startswith("#"):
                 self.buffer.add(target, sender, text)
+        elif msg.command == "ROOMINVITE" and len(msg.params) >= 3:
+            channel = msg.params[0]
+            meta_text = msg.params[2]
+            if self.on_roominvite:
+                self.on_roominvite(channel, meta_text)

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/opencode/config.py

@@ -47,6 +47,7 @@ class AgentConfig:
     channels: list[str] = field(default_factory=lambda: ["#general"])
     model: str = "anthropic/claude-sonnet-4-6"
     system_prompt: str = ""
+    tags: list[str] = field(default_factory=list)
 
 
 @dataclass

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/opencode/daemon.py

@@ -102,6 +102,8 @@ class OpenCodeDaemon:
             channels=list(self.agent.channels),
             buffer=self._buffer,
             on_mention=self._on_mention,
+            tags=list(self.agent.tags),
+            on_roominvite=self._on_roominvite,
         )
         await self._transport.connect()
 
@@ -272,6 +274,50 @@ class OpenCodeDaemon:
                 prompt = f"[IRC DM] <{sender}> {text}"
             asyncio.create_task(self._agent_runner.send_prompt(prompt))
 
+    def _on_roominvite(self, channel: str, meta_text: str) -> None:
+        """Called by IRCTransport when a ROOMINVITE is received."""
+        asyncio.create_task(self._handle_roominvite(channel, meta_text))
+
+    async def _handle_roominvite(self, channel: str, meta_text: str) -> None:
+        """Evaluate a room invitation using the agent's LLM."""
+        from agentirc.server.rooms_util import parse_room_meta
+
+        meta = parse_room_meta(meta_text)
+        purpose = meta.get("purpose", "")
+        instructions = meta.get("instructions", "")
+        tags = meta.get("tags", "")
+        requestor = meta.get("requestor")
+
+        prompt = (
+            f"You've been invited to join IRC room {channel}.\n"
+            f"Purpose: {purpose}\n"
+            f"Instructions: {instructions}\n"
+            f"Room tags: {tags}\n"
+            f"Your tags: {','.join(self.agent.tags)}\n\n"
+            "Think step-by-step about whether this room fits your current work "
+            "and capabilities. Then decide: should you join? Answer YES or NO."
+        )
+
+        if self._agent_runner is None or not self._agent_runner.is_running():
+            # No live agent — auto-join without evaluation
+            logger.info(
+                "ROOMINVITE for %s: no agent runner active, auto-joining %s",
+                self.agent.nick, channel,
+            )
+            assert self._transport is not None
+            await self._transport.send_raw(f"JOIN {channel}")
+            return
+
+        # Use the agent runner to evaluate
+        # Enqueue a None relay target so the evaluation response doesn't
+        # steal a real mention's relay target from the deque.
+        self._mention_targets.append(None)
+        await self._agent_runner.send_prompt(prompt)
+        logger.info(
+            "ROOMINVITE for %s on %s — evaluation prompt sent to agent",
+            self.agent.nick, channel,
+        )
+
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
         # Dequeue the relay target that corresponds to this turn

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/clients/opencode/irc_transport.py

@@ -15,7 +15,9 @@ class IRCTransport:
 
     def __init__(self, host: str, port: int, nick: str, user: str,
                  channels: list[str], buffer: MessageBuffer,
-                 on_mention: Callable[[str, str, str], None] | None = None):
+                 on_mention: Callable[[str, str, str], None] | None = None,
+                 tags: list[str] | None = None,
+                 on_roominvite: Callable[[str, str], None] | None = None):
         self.host = host
         self.port = port
         self.nick = nick
@@ -23,6 +25,8 @@ class IRCTransport:
         self.channels = list(channels)
         self.buffer = buffer
         self.on_mention = on_mention
+        self.tags = tags or []
+        self.on_roominvite = on_roominvite
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -136,6 +140,10 @@ class IRCTransport:
             self.connected = True
             for channel in self.channels:
                 await self._send_raw(f"JOIN {channel}")
+            # Announce agent tags on connect
+            if self.tags:
+                tags_str = ",".join(self.tags)
+                await self._send_raw(f"TAGS {self.nick} {tags_str}")
         elif msg.command == "PRIVMSG" and len(msg.params) >= 2:
             target = msg.params[0]
             text = msg.params[1]
@@ -154,3 +162,8 @@ class IRCTransport:
             sender = msg.prefix.split("!")[0] if msg.prefix else "server"
             if target.startswith("#"):
                 self.buffer.add(target, sender, text)
+        elif msg.command == "ROOMINVITE" and len(msg.params) >= 3:
+            channel = msg.params[0]
+            meta_text = msg.params[2]
+            if self.on_roominvite:
+                self.on_roominvite(channel, meta_text)

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/overview/collector.py

@@ -63,6 +63,7 @@ async def collect_mesh_state(
                 room_agents.append(agent)
 
             op_nicks = [n for n, is_op in members if is_op]
+            room_meta = await _query_roommeta(reader, writer, nick, ch_name)
             rooms.append(Room(
                 name=ch_name,
                 topic=ch_topic,
@@ -70,6 +71,11 @@ async def collect_mesh_state(
                 operators=op_nicks,
                 federation_servers=sorted(fed_servers),
                 messages=messages,
+                room_id=room_meta.get("room_id"),
+                owner=room_meta.get("owner"),
+                purpose=room_meta.get("purpose"),
+                tags=room_meta.get("tags", []),
+                persistent=room_meta.get("persistent", False),
             ))
 
         fed_links = sorted({a.server for a in all_agents.values() if a.server != server_name})
@@ -78,6 +84,11 @@ async def collect_mesh_state(
         if ipc_enabled:
             await _enrich_via_ipc(all_agents, server_name)
 
+        # Enrich local agents with TAGS
+        for agent_nick, agent in all_agents.items():
+            if agent.server == server_name:
+                agent.tags = await _query_tags(reader, writer, nick, agent_nick)
+
         return MeshState(
             server_name=server_name,
             rooms=rooms,
@@ -245,6 +256,53 @@ async def _query_history(
     return result
 
 
+async def _query_roommeta(
+    reader: asyncio.StreamReader,
+    writer: asyncio.StreamWriter,
+    nick: str,
+    channel: str,
+) -> dict:
+    """Query ROOMMETA and return a dict with room metadata fields."""
+    writer.write(f"ROOMMETA {channel}\r\n".encode())
+    await writer.drain()
+    messages = await _recv_until(reader, writer, {"ROOMETAEND", "ERR_NOSUCHCHANNEL", "ERR_UNKNOWNCOMMAND"})
+    result: dict = {}
+    for msg in messages:
+        if msg.command == "ROOMMETA" and len(msg.params) >= 3:
+            # Server sends: ROOMMETA <channel> <key> <value>
+            key = msg.params[1].strip().lower()
+            value = msg.params[2]
+            if key == "room_id":
+                result["room_id"] = value
+            elif key == "owner":
+                result["owner"] = value
+            elif key == "purpose":
+                result["purpose"] = value
+            elif key == "tags":
+                result["tags"] = [t.strip() for t in value.split(",") if t.strip()]
+            elif key == "persistent":
+                result["persistent"] = value.lower() in ("1", "true", "yes")
+    return result
+
+
+async def _query_tags(
+    reader: asyncio.StreamReader,
+    writer: asyncio.StreamWriter,
+    nick: str,
+    target_nick: str,
+) -> list[str]:
+    """Query TAGS for an agent and return a list of tag strings."""
+    writer.write(f"TAGS {target_nick}\r\n".encode())
+    await writer.drain()
+    messages = await _recv_until(reader, writer, {"TAGSEND", "ERR_NOSUCHNICK", "ERR_UNKNOWNCOMMAND"})
+    for msg in messages:
+        if msg.command == "TAGS" and len(msg.params) >= 2:
+            # Expected format: TAGS <nick> <tag1,tag2,...>
+            tags_str = msg.params[-1]
+            return [t.strip() for t in tags_str.split(",") if t.strip()]
+    return []
+
+
 async def _enrich_via_ipc(agents: dict[str, Agent], server_name: str) -> None:
     """Enrich local agents with daemon IPC status data."""
     from agentirc.clients.claude.ipc import decode_message, encode_message, make_request

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/overview/model.py

@@ -27,6 +27,7 @@ class Agent:
     directory: str | None = None
     turns: int | None = None
     uptime: str | None = None
+    tags: list[str] = field(default_factory=list)
 
     @property
     def is_local(self) -> bool:
@@ -42,6 +43,11 @@ class Room:
     operators: list[str]
     federation_servers: list[str]
     messages: list[Message]
+    room_id: str | None = None
+    owner: str | None = None
+    purpose: str | None = None
+    tags: list[str] = field(default_factory=list)
+    persistent: bool = False
 
 
 @dataclass

{agentirc_cli-0.14.0 → agentirc_cli-0.15.0}/agentirc/overview/renderer_text.py

@@ -50,6 +50,16 @@ def _render_room(room: Room, message_limit: int) -> str:
     """Render a single room section."""
     parts = [f"## {room.name}"]
     parts.append(f"Topic: {room.topic}" if room.topic else "Topic: (none)")
+    if room.room_id:
+        parts.append(f"Purpose: {room.purpose or ''}")
+        parts.append(f"Tags: {', '.join(room.tags) if room.tags else 'none'}")
+        meta_parts = []
+        if room.owner:
+            meta_parts.append(f"Owner: {room.owner}")
+        if room.persistent:
+            meta_parts.append("Persistent")
+        if meta_parts:
+            parts.append(" | ".join(meta_parts))
     parts.append("")
     parts.append(_agent_table(room.members))
     parts.append("")
@@ -150,11 +160,13 @@ def _render_agent_detail(mesh: MeshState, nick: str, message_limit: int) -> str:
         rows.append(("Turns", str(agent.turns)))
     if agent.uptime:
         rows.append(("Uptime", agent.uptime))
+    if agent.tags:
+        rows.append(("Tags", ", ".join(agent.tags)))
 
     parts.append("| Field | Value |")
     parts.append("|-------|-------|")
     for field_name, value in rows:
-        parts.append(f"| {field_name} | {value} |")
+        parts.append(f"| {field_name} | {_escape_cell(value)} |")
 
     # Channels table
     parts.append("")