agentirc-cli 6.1.1__tar.gz → 6.2.0__tar.gz

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [6.2.0] - 2026-04-12
+
+
+### Added
+
+- Agent status indicators in console sidebar (#218) — shows working/idle/paused/circuit-open for each agent
+- Auto-read channel history on switch (#219) — loads last 20 messages when switching channels via Tab, sidebar click, or /join
+- Help menu — /help command and Ctrl+H keybinding showing all commands and keybindings
+
+
+### Fixed
+
+- Joined message no longer wiped by channel switch clear_log
+
 ## [6.1.1] - 2026-04-11
 
 

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 6.1.1
+Version: 6.2.0
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 The complete human-agent collaboration system built around AgentIRC.
 
 **AgentIRC** is the IRC-native runtime for persistent AI agents and humans in shared live rooms.
-**Culture** is the full solution — CLI, harnesses, workflows, and multi-machine mesh.
+**Culture** is the full solution — CLI, harnesses, console, workflows, and multi-machine mesh.
 
 ## Start here
 

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/README.md

@@ -3,7 +3,7 @@
 The complete human-agent collaboration system built around AgentIRC.
 
 **AgentIRC** is the IRC-native runtime for persistent AI agents and humans in shared live rooms.
-**Culture** is the full solution — CLI, harnesses, workflows, and multi-machine mesh.
+**Culture** is the full solution — CLI, harnesses, console, workflows, and multi-machine mesh.
 
 ## Start here
 

agentirc_cli-6.2.0/culture/cli/shared/constants.py

@@ -0,0 +1,43 @@
+"""Shared constants for culture CLI modules."""
+
+import os
+import stat
+
+from culture.bots.config import BOT_CONFIG_FILE  # noqa: F401
+
+DEFAULT_CONFIG = os.path.expanduser("~/.culture/server.yaml")
+LOG_DIR = os.path.expanduser("~/.culture/logs")
+
+_CONFIG_HELP = "Config file path"
+_SERVER_NAME_HELP = "Server name"
+_BOT_NAME_HELP = "Bot name"
+
+DEFAULT_CHANNEL = "#general"
+NO_AGENTS_MSG = "No agents configured"
+CULTURE_DIR = ".culture"
+AGENTS_YAML = "agents.yaml"
+
+DEFAULT_SERVER_CONFIG = os.path.expanduser("~/.culture/server.yaml")
+LEGACY_CONFIG = os.path.expanduser("~/.culture/agents.yaml")
+
+
+def culture_runtime_dir() -> str:
+    """Return a safe directory for culture daemon sockets.
+
+    Uses ``$XDG_RUNTIME_DIR`` when available (user-private, set by
+    systemd/logind).  Otherwise creates a user-private subdirectory
+    under the system temp dir so sockets never live in a publicly
+    writable location.
+    """
+    xdg = os.environ.get("XDG_RUNTIME_DIR")
+    if xdg:
+        return xdg
+    fallback = os.path.join(
+        os.path.expanduser("~"),
+        ".culture",
+        "run",
+    )
+    os.makedirs(fallback, mode=0o700, exist_ok=True)
+    # Enforce permissions even if the directory already existed
+    os.chmod(fallback, stat.S_IRWXU)
+    return fallback

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/culture/cli/shared/ipc.py

@@ -9,8 +9,10 @@ from culture.config import load_config_or_default
 
 
 def agent_socket_path(nick: str) -> str:
+    from culture.cli.shared.constants import culture_runtime_dir
+
     return os.path.join(
-        os.environ.get("XDG_RUNTIME_DIR", "/tmp"),
+        culture_runtime_dir(),
         f"culture-{nick}.sock",
     )
 

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/culture/console/app.py

@@ -15,6 +15,7 @@ from textual.widgets import Footer, Header
 from culture.aio import maybe_await
 from culture.console.client import ConsoleIRCClient
 from culture.console.commands import CommandType, parse_command
+from culture.console.status import query_all_agents
 from culture.console.widgets.chat import ChatPanel
 from culture.console.widgets.info_panel import InfoPanel
 from culture.console.widgets.sidebar import ChannelItem, EntityItem, Sidebar
@@ -22,6 +23,7 @@ from culture.console.widgets.sidebar import ChannelItem, EntityItem, Sidebar
 logger = logging.getLogger(__name__)
 
 BUFFER_INTERVAL = 10.0  # seconds between UI refreshes
+STATUS_POLL_INTERVAL = 30.0  # seconds between agent status polls
 
 
 class ConsoleApp(App):
@@ -33,6 +35,7 @@ class ConsoleApp(App):
     BINDINGS = [
         Binding("ctrl+o", "show_overview", "Overview", show=True),
         Binding("ctrl+s", "show_status", "Status", show=True),
+        Binding("ctrl+h", "show_help", "Help", show=True),
         Binding("escape", "back_to_chat", "Chat", show=True),
         Binding("ctrl+q", "quit_app", "Quit", show=True),
         Binding("tab", "next_channel", "Next channel", show=False),
@@ -65,6 +68,7 @@ class ConsoleApp(App):
 
         self._buffer_task: asyncio.Task | None = None
         self._background_tasks: set[asyncio.Task] = set()
+        self._status_poll_task: asyncio.Task | None = None
 
         # Dispatch table for command execution
         self._command_handlers: dict[CommandType, Any] = {
@@ -84,6 +88,7 @@ class ConsoleApp(App):
             CommandType.INVITE: self._handle_invite,
             CommandType.SERVER: self._handle_server,
             CommandType.QUIT: self._handle_quit,
+            CommandType.HELP: self._handle_help,
         }
 
     # ------------------------------------------------------------------
@@ -106,6 +111,7 @@ class ConsoleApp(App):
         """Set sub-title and kick off the buffer-drain loop."""
         self.sub_title = f"{self._client.nick}@{self._server_name}"
         self._buffer_task = asyncio.create_task(self._buffer_loop())
+        self._status_poll_task = asyncio.create_task(self._status_poll_loop())
 
         # Populate sidebar with any channels already joined at startup
         self._sync_sidebar()
@@ -140,6 +146,43 @@ class ConsoleApp(App):
                     text=msg.text,
                 )
 
+    async def _status_poll_loop(self) -> None:
+        """Periodically poll agent daemon sockets for status updates."""
+        # Initial poll on startup
+        await self._poll_agent_status()
+        while True:
+            try:
+                await asyncio.sleep(STATUS_POLL_INTERVAL)
+                await self._poll_agent_status()
+            except asyncio.CancelledError:
+                raise
+            except Exception:
+                logger.exception("Error in _status_poll_loop")
+
+    async def _poll_agent_status(self) -> None:
+        """Query daemon sockets and update sidebar entity activity."""
+        status_map = await query_all_agents()
+        if not status_map:
+            return
+        sidebar: Sidebar = self.query_one(Sidebar)
+        updated = False
+        new_entities = []
+        for ent in sidebar.entities:
+            if ent.nick in status_map:
+                new_ent = EntityItem(
+                    nick=ent.nick,
+                    entity_type=ent.entity_type,
+                    online=ent.online,
+                    icon=ent.icon,
+                    activity=status_map[ent.nick],
+                )
+                new_entities.append(new_ent)
+                updated = True
+            else:
+                new_entities.append(ent)
+        if updated:
+            sidebar.entities = new_entities
+
     # ------------------------------------------------------------------
     # Input handler
     # ------------------------------------------------------------------
@@ -189,9 +232,8 @@ class ConsoleApp(App):
             return
         channel = cmd.args[0]
         await self._client.join(channel)
-        self._current_channel = channel
         self._sync_sidebar()
-        chat.set_channel(channel)
+        await self._switch_to_channel(channel)
         chat.add_message(time.time(), "", "system", f"Joined [bold]{channel}[/]")
 
     async def _handle_part(self, cmd) -> None:  # noqa: ANN001
@@ -341,6 +383,51 @@ class ConsoleApp(App):
     async def _handle_quit(self, cmd) -> None:  # noqa: ANN001
         await self.action_quit_app()
 
+    def _handle_help(self, cmd) -> None:  # noqa: ANN001
+        self.action_show_help()
+
+    def action_show_help(self) -> None:
+        """Show help content with all commands and keybindings."""
+        self._current_view = "help"
+        chat: ChatPanel = self.query_one(ChatPanel)
+        lines = [
+            "[bold $warning]COMMANDS[/]",
+            "",
+            "  [bold]/help[/]                  Show this help",
+            "  [bold]/join[/] #channel         Join a channel",
+            "  [bold]/part[/] [#channel]       Leave a channel",
+            "  [bold]/read[/] [#ch] [-n N]     Read channel history (default 50)",
+            "  [bold]/who[/] [target]          List channel members",
+            "  [bold]/send[/] <target> <text>  Send a direct message",
+            "  [bold]/channels[/]              List server channels",
+            "  [bold]/agents[/]                List visible agents",
+            "  [bold]/status[/] [agent]        Show status info",
+            "  [bold]/overview[/]              Show mesh overview",
+            "  [bold]/icon[/] <emoji>          Set your icon",
+            "  [bold]/topic[/] #ch <text>      Set channel topic",
+            "  [bold]/kick[/] #ch <nick>       Kick a user",
+            "  [bold]/invite[/] <nick> #ch     Invite a user",
+            "  [bold]/server[/] [name]         Switch server (restarts console)",
+            "  [bold]/quit[/]                  Exit console",
+            "",
+            "[bold $warning]KEYBINDINGS[/]",
+            "",
+            "  [bold]Tab / Shift+Tab[/]        Cycle channels",
+            "  [bold]Ctrl+O[/]                 Overview",
+            "  [bold]Ctrl+S[/]                 Status",
+            "  [bold]Ctrl+H[/]                 Help",
+            "  [bold]Escape[/]                 Back to chat",
+            "  [bold]Ctrl+Q[/]                 Quit",
+        ]
+        chat.set_content("Help", lines)
+
+        # Hide input — not meaningful in help view
+        try:
+            input_widget = self.query_one(self._CHAT_INPUT_ID)
+            input_widget.display = False
+        except Exception:
+            pass
+
     # ------------------------------------------------------------------
     # View actions
     # ------------------------------------------------------------------
@@ -468,8 +555,15 @@ class ConsoleApp(App):
         chat.set_content("Agents", lines)
 
         # Update sidebar entity roster
+        status_map = await query_all_agents()
         entity_items = [
-            EntityItem(nick=nick, entity_type="agent", online=True) for nick in sorted(all_agents)
+            EntityItem(
+                nick=nick,
+                entity_type="agent",
+                online=True,
+                activity=status_map.get(nick, ""),
+            )
+            for nick in sorted(all_agents)
         ]
         sidebar.entities = entity_items
 
@@ -506,16 +600,15 @@ class ConsoleApp(App):
         if not channels:
             return
         if self._current_channel not in channels:
-            self._current_channel = channels[0]
+            target = channels[0]
         else:
             idx = channels.index(self._current_channel)
             idx = (idx + direction) % len(channels)
-            self._current_channel = channels[idx]
+            target = channels[idx]
 
-        chat: ChatPanel = self.query_one(ChatPanel)
-        sidebar: Sidebar = self.query_one(Sidebar)
-        chat.set_channel(self._current_channel)
-        sidebar.active_channel = self._current_channel
+        task = asyncio.create_task(self._switch_to_channel(target))
+        self._background_tasks.add(task)
+        task.add_done_callback(self._background_tasks.discard)
 
     # ------------------------------------------------------------------
     # Quit
@@ -523,10 +616,14 @@ class ConsoleApp(App):
 
     async def action_quit_app(self) -> None:
         """Disconnect the IRC client and exit the app."""
-        if self._buffer_task:
-            self._buffer_task.cancel()
-            await asyncio.gather(self._buffer_task, return_exceptions=True)
-            self._buffer_task = None
+        for task_ref in (self._buffer_task, self._status_poll_task):
+            if task_ref:
+                task_ref.cancel()
+        tasks_to_cancel = [t for t in (self._buffer_task, self._status_poll_task) if t]
+        if tasks_to_cancel:
+            await asyncio.gather(*tasks_to_cancel, return_exceptions=True)
+        self._buffer_task = None
+        self._status_poll_task = None
 
         if self._client.connected:
             try:
@@ -542,19 +639,9 @@ class ConsoleApp(App):
 
     def on_sidebar_channel_selected(self, event: Sidebar.ChannelSelected) -> None:
         """Switch to the selected channel when user clicks sidebar."""
-        self._current_channel = event.channel
-        self._current_view = "chat"
-        chat: ChatPanel = self.query_one(ChatPanel)
-        sidebar: Sidebar = self.query_one(Sidebar)
-        chat.set_channel(self._current_channel)
-        sidebar.active_channel = self._current_channel
-
-        # Re-show input if hidden
-        try:
-            input_widget = self.query_one(self._CHAT_INPUT_ID)
-            input_widget.display = True
-        except Exception:
-            pass
+        task = asyncio.create_task(self._switch_to_channel(event.channel))
+        self._background_tasks.add(task)
+        task.add_done_callback(self._background_tasks.discard)
 
     def on_sidebar_entity_selected(self, event: Sidebar.EntitySelected) -> None:
         """Show agent detail when user clicks an entity in the sidebar."""
@@ -566,6 +653,41 @@ class ConsoleApp(App):
     # Internal helpers
     # ------------------------------------------------------------------
 
+    async def _switch_to_channel(self, channel: str) -> None:
+        """Switch to a channel, update UI, and auto-load recent history."""
+        if not channel:
+            return
+        # Guard against stale results from rapid switching
+        self._current_channel = channel
+        self._current_view = "chat"
+
+        sidebar: Sidebar = self.query_one(Sidebar)
+        chat: ChatPanel = self.query_one(ChatPanel)
+        sidebar.active_channel = channel
+        chat.set_channel(channel)
+        chat.clear_log()
+
+        # Re-show input if hidden (e.g., coming from overview/status view)
+        try:
+            input_widget = self.query_one(self._CHAT_INPUT_ID)
+            input_widget.display = True
+        except Exception:
+            pass
+
+        # Fetch recent history
+        entries = await self._client.history(channel, limit=20)
+        # Stale check: if user switched away during fetch, discard results
+        if self._current_channel != channel:
+            return
+        for e in entries:
+            try:
+                ts = float(e.get("timestamp", 0))
+            except (ValueError, TypeError):
+                ts = time.time()
+            chat.add_message(ts, "", e.get("nick", ""), e.get("text", ""))
+        if not entries:
+            chat.add_message(time.time(), "", "system", f"[dim]No history for {channel}[/]")
+
     def _sync_sidebar(self) -> None:
         """Sync the sidebar channel list from the client's joined_channels."""
         sidebar: Sidebar = self.query_one(Sidebar)

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/culture/console/commands.py

@@ -26,6 +26,7 @@ class CommandType(Enum):
     INVITE = auto()
     SERVER = auto()
     QUIT = auto()
+    HELP = auto()
     UNKNOWN = auto()
 
 
@@ -60,6 +61,7 @@ _COMMANDS: dict[str, CommandType] = {
     "invite": CommandType.INVITE,
     "server": CommandType.SERVER,
     "quit": CommandType.QUIT,
+    "help": CommandType.HELP,
 }
 
 

agentirc_cli-6.2.0/culture/console/status.py

@@ -0,0 +1,74 @@
+"""Lightweight daemon IPC status queries for the console."""
+
+from __future__ import annotations
+
+import logging
+import os
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+
+def discover_agent_sockets() -> list[tuple[str, Path]]:
+    """List culture daemon sockets in the culture runtime directory.
+
+    Returns a list of ``(nick, socket_path)`` tuples.
+    """
+    from culture.cli.shared.constants import culture_runtime_dir
+
+    runtime_dir = Path(culture_runtime_dir())
+    results: list[tuple[str, Path]] = []
+    if not runtime_dir.is_dir():
+        return results
+    for entry in runtime_dir.iterdir():
+        if entry.name.startswith("culture-") and entry.name.endswith(".sock") and entry.is_socket():
+            nick = entry.name[len("culture-") : -len(".sock")]
+            results.append((nick, entry))
+    return results
+
+
+async def query_agent_status(socket_path: Path) -> dict:
+    """Query a single daemon socket for status (no LLM query).
+
+    Returns a dict with ``activity``, ``paused``, ``circuit_open``,
+    ``running`` keys, or an empty dict on failure.
+    """
+    from culture.cli.shared.ipc import ipc_request
+
+    resp = await ipc_request(str(socket_path), "status")
+    if resp is None or not resp.get("ok"):
+        return {}
+    return resp.get("data", {})
+
+
+def _derive_activity(data: dict) -> str:
+    """Derive a single activity string from daemon status fields."""
+    if data.get("circuit_open"):
+        return "circuit-open"
+    if data.get("paused"):
+        return "paused"
+    if not data.get("running"):
+        return "idle"
+    return data.get("activity", "idle")
+
+
+async def query_all_agents() -> dict[str, str]:
+    """Query all local daemon sockets and return nick -> activity mapping."""
+    import asyncio
+
+    sockets = discover_agent_sockets()
+    if not sockets:
+        return {}
+
+    results: dict[str, str] = {}
+
+    async def _query_one(nick: str, path: Path) -> None:
+        try:
+            data = await asyncio.wait_for(query_agent_status(path), timeout=3.0)
+            if data:
+                results[nick] = _derive_activity(data)
+        except Exception:
+            logger.debug("Failed to query status for %s", nick)
+
+    await asyncio.gather(*[_query_one(nick, path) for nick, path in sockets])
+    return results

{agentirc_cli-6.1.1 → agentirc_cli-6.2.0}/culture/console/widgets/sidebar.py

@@ -32,6 +32,7 @@ class EntityItem:
     entity_type: str = "agent"  # "agent" | "admin" | "human" | "bot"
     online: bool = True
     icon: str = ""
+    activity: str = ""  # "working" | "idle" | "paused" | "circuit-open" | ""
 
 
 # ---------------------------------------------------------------------------
@@ -46,6 +47,14 @@ _TYPE_ICON: dict[str, str] = {
     "bot": "⚙",
 }
 
+# Activity indicators for agent status
+_ACTIVITY_INDICATOR: dict[str, str] = {
+    "working": "[green]●[/]",
+    "idle": "[dim]○[/]",
+    "paused": "[yellow]⏸[/]",
+    "circuit-open": "[red]⚠[/]",
+}
+
 # Group order for entity types
 _GROUP_ORDER = ["agent", "admin", "human", "bot"]
 
@@ -105,7 +114,12 @@ class _EntityRow(Static):
     """
 
     def __init__(self, entity: EntityItem) -> None:
-        dot = "[green]●[/]" if entity.online else "[dim]○[/]"
+        if entity.activity and entity.activity in _ACTIVITY_INDICATOR:
+            dot = _ACTIVITY_INDICATOR[entity.activity]
+        elif entity.online:
+            dot = "●"
+        else:
+            dot = "[dim]○[/]"
         icon = entity.icon or _TYPE_ICON.get(entity.entity_type, "")
         markup = f"{dot} {icon} {entity.nick}"
         super().__init__(markup, markup=True)