agentirc-cli 2.0.1__tar.gz → 3.0.1__tar.gz

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [3.0.1] - 2026-04-06
+
+
+### Fixed
+
+- Fix empty error message when running `culture overview` against a starting or unreachable server
+
+## [3.0.0] - 2026-04-06
+
+
+### Added
+
+- Console chat TUI for human participation in the IRC mesh (culture console)
+- ICON IRC protocol extension for custom entity icons
+- User modes (+H/+A/+B) for entity type identification
+- Server discovery and default server management
+- Three-column TUI layout with sidebar, chat, and info panel
+- View switching: overview, status, agent detail
+- Command parser with full CLI command parity
+
 ## [2.0.1] - 2026-04-05
 
 

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 2.0.1
+Version: 3.0.1
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum
@@ -17,6 +17,7 @@ Requires-Dist: anthropic>=0.40
 Requires-Dist: claude-agent-sdk>=0.1
 Requires-Dist: mistune>=3.0
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: textual>=1.0
 Provides-Extra: copilot
 Requires-Dist: github-copilot-sdk; extra == 'copilot'
 Description-Content-Type: text/markdown
@@ -72,18 +73,18 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 ## Why Culture
 
-| | Culture | Ruflo |
-|---|---|---|
-| **Architecture** | Peer mesh — no hierarchy, servers link as equals | Queen-led swarm hierarchies with centralized ledger |
-| **Protocol** | IRC (simple, text-native, LLM-familiar) — any client connects | Proprietary CLI/MCP with custom messaging |
-| **Federation** | Real server-to-server across machines | Within single orchestration instance |
-| **Agent backends** | Claude, Codex, Copilot, ACP (any) — each runs natively | Multi-LLM routing, primarily Claude-focused |
-| **Human participation** | First-class — same protocol, any IRC client | Pair programming modes with verification gates |
-| **Lifecycle** | Persistent daemons with sleep/wake cycles | Lifecycle hooks, no explicit sleep/wake |
-| **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + fallback agents |
-| **Observability** | Live web dashboard + any IRC client | CLI commands (metrics partially mocked) |
-| **Self-organization** | Tag-driven room membership | ML-based routing with learning pipeline |
-| **Philosophy** | Simple, organic, transparent | Enterprise-complex (130+ skills, vector DB, Q-learning) |
+| | Culture | Agent Orchestrator | Ruflo |
+|---|---|---|---|
+| **Architecture** | Peer mesh — no hierarchy, servers link as equals | Plugin-based orchestrator — spawns workers per issue | Queen-led swarm hierarchies with centralized ledger |
+| **Protocol** | IRC (simple, text-native, LLM-familiar) — any client connects | Git worktrees + GitHub/GitLab APIs | Proprietary CLI/MCP with custom messaging |
+| **Federation** | Real server-to-server across machines | Single-machine orchestration | Within single orchestration instance |
+| **Agent backends** | Claude, Codex, Copilot, ACP (any) — each runs natively | Claude Code, Codex, Aider, OpenCode — plugin-swappable | Multi-LLM routing, primarily Claude-focused |
+| **Human participation** | First-class — same protocol, any IRC client | Dashboard supervisor — pulled in for approvals | Pair programming modes with verification gates |
+| **Lifecycle** | Persistent daemons with sleep/wake cycles | Spawns per-issue, cleans up after merge | Lifecycle hooks, no explicit sleep/wake |
+| **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + escalation timeouts | Retry limits + fallback agents |
+| **Observability** | Live web dashboard + any IRC client | Web dashboard + Slack/Discord/webhook alerts | CLI commands (metrics partially mocked) |
+| **Self-organization** | Tag-driven room membership | Orchestrator assigns issues to workers | ML-based routing with learning pipeline |
+| **Philosophy** | Simple, organic, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
 
 ---
 

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/README.md

@@ -49,18 +49,18 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 ## Why Culture
 
-| | Culture | Ruflo |
-|---|---|---|
-| **Architecture** | Peer mesh — no hierarchy, servers link as equals | Queen-led swarm hierarchies with centralized ledger |
-| **Protocol** | IRC (simple, text-native, LLM-familiar) — any client connects | Proprietary CLI/MCP with custom messaging |
-| **Federation** | Real server-to-server across machines | Within single orchestration instance |
-| **Agent backends** | Claude, Codex, Copilot, ACP (any) — each runs natively | Multi-LLM routing, primarily Claude-focused |
-| **Human participation** | First-class — same protocol, any IRC client | Pair programming modes with verification gates |
-| **Lifecycle** | Persistent daemons with sleep/wake cycles | Lifecycle hooks, no explicit sleep/wake |
-| **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + fallback agents |
-| **Observability** | Live web dashboard + any IRC client | CLI commands (metrics partially mocked) |
-| **Self-organization** | Tag-driven room membership | ML-based routing with learning pipeline |
-| **Philosophy** | Simple, organic, transparent | Enterprise-complex (130+ skills, vector DB, Q-learning) |
+| | Culture | Agent Orchestrator | Ruflo |
+|---|---|---|---|
+| **Architecture** | Peer mesh — no hierarchy, servers link as equals | Plugin-based orchestrator — spawns workers per issue | Queen-led swarm hierarchies with centralized ledger |
+| **Protocol** | IRC (simple, text-native, LLM-familiar) — any client connects | Git worktrees + GitHub/GitLab APIs | Proprietary CLI/MCP with custom messaging |
+| **Federation** | Real server-to-server across machines | Single-machine orchestration | Within single orchestration instance |
+| **Agent backends** | Claude, Codex, Copilot, ACP (any) — each runs natively | Claude Code, Codex, Aider, OpenCode — plugin-swappable | Multi-LLM routing, primarily Claude-focused |
+| **Human participation** | First-class — same protocol, any IRC client | Dashboard supervisor — pulled in for approvals | Pair programming modes with verification gates |
+| **Lifecycle** | Persistent daemons with sleep/wake cycles | Spawns per-issue, cleans up after merge | Lifecycle hooks, no explicit sleep/wake |
+| **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + escalation timeouts | Retry limits + fallback agents |
+| **Observability** | Live web dashboard + any IRC client | Web dashboard + Slack/Discord/webhook alerts | CLI commands (metrics partially mocked) |
+| **Self-organization** | Tag-driven room membership | Orchestrator assigns issues to workers | ML-based routing with learning pipeline |
+| **Philosophy** | Simple, organic, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
 
 ---
 

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/cli.py

@@ -18,6 +18,7 @@ Subcommands:
     culture overview [--room X] [--agent X] Show mesh overview
     culture setup [--config X] [--uninstall] Set up mesh from mesh.yaml
     culture update [--dry-run] [--skip-upgrade] Upgrade and restart mesh
+    culture console [server_name]              Interactive admin console TUI
 """
 
 from __future__ import annotations
@@ -131,6 +132,9 @@ def _build_parser() -> argparse.ArgumentParser:
     srv_status = server_sub.add_parser("status", help="Check server daemon status")
     srv_status.add_argument("--name", default="culture", help="Server name")
 
+    srv_default = server_sub.add_parser("default", help="Set default server")
+    srv_default.add_argument("name", help="Server name to set as default")
+
     # -- create / join subcommands -----------------------------------------
     # 'create' registers an agent definition; 'join' adds it to the mesh.
     # 'init' is a deprecated alias for 'create'.
@@ -316,6 +320,20 @@ def _build_parser() -> argparse.ArgumentParser:
     bot_inspect.add_argument("name", help="Bot name")
     bot_inspect.add_argument("--config", default=DEFAULT_CONFIG, help="Config file path")
 
+    # -- console subcommand ------------------------------------------------
+    console_parser = sub.add_parser("console", help="Interactive admin console")
+    console_parser.add_argument(
+        "server_name",
+        nargs="?",
+        default=None,
+        help="Server to connect to (auto-detects if omitted)",
+    )
+    console_parser.add_argument(
+        "--config",
+        default=DEFAULT_CONFIG,
+        help="Config file path",
+    )
+
     return parser
 
 
@@ -353,6 +371,7 @@ def main() -> None:
             "setup": _cmd_setup,
             "update": _cmd_update,
             "bot": _cmd_bot,
+            "console": _cmd_console,
         }
         handler = dispatch.get(args.command)
         if handler:
@@ -367,6 +386,90 @@ def main() -> None:
         sys.exit(1)
 
 
+# -----------------------------------------------------------------------
+# Console subcommand
+# -----------------------------------------------------------------------
+
+
+def _resolve_server(server_name: str | None) -> tuple[str, int] | None:
+    """Resolve server name and port from running servers.
+
+    Returns (server_name, port) or None if no servers are running.
+    """
+    from culture.pidfile import list_servers, read_default_server, read_port
+
+    if server_name:
+        p = read_port(server_name)
+        port = p if p else 6667
+        return server_name, port
+
+    servers = list_servers()
+    if not servers:
+        return None
+
+    if len(servers) == 1:
+        return servers[0]["name"], servers[0]["port"]
+
+    default = read_default_server()
+    if default:
+        match = [s for s in servers if s["name"] == default]
+        if match:
+            return match[0]["name"], match[0]["port"]
+
+    return servers[0]["name"], servers[0]["port"]
+
+
+def _cmd_console(args: argparse.Namespace) -> None:
+    """Launch the interactive console TUI."""
+    result = _resolve_server(args.server_name)
+    if result is None:
+        print("No culture servers running. Start one with: culture server start")
+        return
+
+    server_name, port = result
+    host = "127.0.0.1"
+
+    nick_suffix = _resolve_console_nick()
+    nick = f"{server_name}-{nick_suffix}"
+
+    from culture.console.app import ConsoleApp
+    from culture.console.client import ConsoleIRCClient
+
+    client = ConsoleIRCClient(host=host, port=port, nick=nick, mode="H")
+
+    async def run():
+        await client.connect()
+        app = ConsoleApp(irc_client=client, server_name=server_name)
+        await app.run_async()
+
+    asyncio.run(run())
+
+
+def _resolve_console_nick() -> str:
+    """Resolve the human nick: git username -> OS user -> config override."""
+    import re
+    import subprocess
+
+    try:
+        result = subprocess.run(
+            ["git", "config", "user.name"],
+            capture_output=True,
+            text=True,
+            timeout=2,
+        )
+        if result.returncode == 0 and result.stdout.strip():
+            name = result.stdout.strip().lower()
+            name = re.sub(r"[^a-z0-9-]", "", name.replace(" ", "-"))
+            if name:
+                return name
+    except (subprocess.SubprocessError, FileNotFoundError):
+        pass
+
+    import os
+
+    return os.environ.get("USER", "human")
+
+
 # -----------------------------------------------------------------------
 # Server subcommands
 # -----------------------------------------------------------------------
@@ -374,7 +477,7 @@ def main() -> None:
 
 def _cmd_server(args: argparse.Namespace) -> None:
     if not args.server_command:
-        print("Usage: culture server {start|stop|status}", file=sys.stderr)
+        print("Usage: culture server {start|stop|status|default}", file=sys.stderr)
         sys.exit(1)
 
     if args.server_command == "start":
@@ -383,6 +486,11 @@ def _cmd_server(args: argparse.Namespace) -> None:
         _server_stop(args)
     elif args.server_command == "status":
         _server_status(args)
+    elif args.server_command == "default":
+        from culture.pidfile import write_default_server
+
+        write_default_server(args.name)
+        print(f"Default server set to '{args.name}'")
 
 
 def _server_start(args: argparse.Namespace) -> None:
@@ -406,6 +514,11 @@ def _server_start(args: argparse.Namespace) -> None:
         print(f"Server '{args.name}' starting in foreground (PID {os.getpid()})")
         print(f"  Listening on {args.host}:{args.port}")
         print(f"  Webhook port: {args.webhook_port}")
+        # Auto-set default server if none is set
+        from culture.pidfile import read_default_server, write_default_server
+
+        if read_default_server() is None:
+            write_default_server(args.name)
         try:
             asyncio.run(_run_server(args.name, args.host, args.port, links, args.webhook_port))
         finally:
@@ -424,6 +537,11 @@ def _server_start(args: argparse.Namespace) -> None:
             print(f"Server '{args.name}' started (PID {pid})")
             print(f"  Listening on {args.host}:{args.port}")
             print(f"  Logs: {LOG_DIR}/server-{args.name}.log")
+            # Auto-set default server if none is set
+            from culture.pidfile import read_default_server, write_default_server
+
+            if read_default_server() is None:
+                write_default_server(args.name)
         else:
             print(f"Server '{args.name}' failed to start", file=sys.stderr)
             sys.exit(1)
@@ -1475,14 +1593,31 @@ def _cmd_overview(args: argparse.Namespace) -> None:
         )
         return
 
-    mesh = asyncio.run(
-        collect_mesh_state(
-            host=config.server.host,
-            port=config.server.port,
-            server_name=config.server.name,
-            message_limit=message_limit,
+    host, port = config.server.host, config.server.port
+    try:
+        mesh = asyncio.run(
+            collect_mesh_state(
+                host=host,
+                port=port,
+                server_name=config.server.name,
+                message_limit=message_limit,
+            )
         )
-    )
+    except ConnectionRefusedError:
+        print(
+            f"Error: could not connect to {host}:{port} — is the server running?",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    except TimeoutError:
+        print(
+            f"Error: server at {host}:{port} not responding" " — it may still be starting up",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    except OSError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        sys.exit(1)
     output = render_text(
         mesh,
         room_filter=args.room,

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/acp/config.py

@@ -59,6 +59,7 @@ class AgentConfig:
     model: str = "anthropic/claude-sonnet-4-6"
     system_prompt: str = ""
     tags: list[str] = field(default_factory=list)
+    icon: str | None = None
 
 
 @dataclass

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/acp/irc_transport.py

@@ -24,6 +24,7 @@ class IRCTransport:
         on_mention: Callable[[str, str, str], None] | None = None,
         tags: list[str] | None = None,
         on_roominvite: Callable[[str, str], None] | None = None,
+        icon: str | None = None,
     ):
         self.host = host
         self.port = port
@@ -34,6 +35,7 @@ class IRCTransport:
         self.on_mention = on_mention
         self.tags = tags or []
         self.on_roominvite = on_roominvite
+        self.icon = icon
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -174,6 +176,8 @@ class IRCTransport:
         if self.tags:
             tags_str = ",".join(self.tags)
             await self._send_raw(f"TAGS {self.nick} {tags_str}")
+        if self.icon:
+            await self._send_raw(f"ICON {self.icon}")
 
     async def _on_privmsg(self, msg: Message) -> None:
         if len(msg.params) < 2:

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/claude/config.py

@@ -59,6 +59,7 @@ class AgentConfig:
     thinking: str = "medium"
     system_prompt: str = ""
     tags: list[str] = field(default_factory=list)
+    icon: str | None = None
 
 
 @dataclass

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/claude/irc_transport.py

@@ -24,6 +24,7 @@ class IRCTransport:
         on_mention: Callable[[str, str, str], None] | None = None,
         tags: list[str] | None = None,
         on_roominvite: Callable[[str, str], None] | None = None,
+        icon: str | None = None,
     ):
         self.host = host
         self.port = port
@@ -34,6 +35,7 @@ class IRCTransport:
         self.on_mention = on_mention
         self.tags = tags or []
         self.on_roominvite = on_roominvite
+        self.icon = icon
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -174,6 +176,8 @@ class IRCTransport:
         if self.tags:
             tags_str = ",".join(self.tags)
             await self._send_raw(f"TAGS {self.nick} {tags_str}")
+        if self.icon:
+            await self._send_raw(f"ICON {self.icon}")
 
     async def _on_privmsg(self, msg: Message) -> None:
         if len(msg.params) < 2:

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/codex/config.py

@@ -57,6 +57,7 @@ class AgentConfig:
     model: str = "gpt-5.4"
     system_prompt: str = ""
     tags: list[str] = field(default_factory=list)
+    icon: str | None = None
 
 
 @dataclass

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/codex/irc_transport.py

@@ -24,6 +24,7 @@ class IRCTransport:
         on_mention: Callable[[str, str, str], None] | None = None,
         tags: list[str] | None = None,
         on_roominvite: Callable[[str, str], None] | None = None,
+        icon: str | None = None,
     ):
         self.host = host
         self.port = port
@@ -34,6 +35,7 @@ class IRCTransport:
         self.on_mention = on_mention
         self.tags = tags or []
         self.on_roominvite = on_roominvite
+        self.icon = icon
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -174,6 +176,8 @@ class IRCTransport:
         if self.tags:
             tags_str = ",".join(self.tags)
             await self._send_raw(f"TAGS {self.nick} {tags_str}")
+        if self.icon:
+            await self._send_raw(f"ICON {self.icon}")
 
     async def _on_privmsg(self, msg: Message) -> None:
         if len(msg.params) < 2:

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/copilot/config.py

@@ -57,6 +57,7 @@ class AgentConfig:
     model: str = "gpt-4.1"
     system_prompt: str = ""
     tags: list[str] = field(default_factory=list)
+    icon: str | None = None
 
 
 @dataclass

{agentirc_cli-2.0.1 → agentirc_cli-3.0.1}/culture/clients/copilot/irc_transport.py

@@ -24,6 +24,7 @@ class IRCTransport:
         on_mention: Callable[[str, str, str], None] | None = None,
         tags: list[str] | None = None,
         on_roominvite: Callable[[str, str], None] | None = None,
+        icon: str | None = None,
     ):
         self.host = host
         self.port = port
@@ -34,6 +35,7 @@ class IRCTransport:
         self.on_mention = on_mention
         self.tags = tags or []
         self.on_roominvite = on_roominvite
+        self.icon = icon
         self.connected = False
         self._reader: asyncio.StreamReader | None = None
         self._writer: asyncio.StreamWriter | None = None
@@ -174,6 +176,8 @@ class IRCTransport:
         if self.tags:
             tags_str = ",".join(self.tags)
             await self._send_raw(f"TAGS {self.nick} {tags_str}")
+        if self.icon:
+            await self._send_raw(f"ICON {self.icon}")
 
     async def _on_privmsg(self, msg: Message) -> None:
         if len(msg.params) < 2:

agentirc_cli-3.0.1/culture/console/__init__.py

@@ -0,0 +1 @@
+"""Console TUI for culture mesh administration."""