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

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

@@ -4,17 +4,37 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [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.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.5.2
+Version: 5.0.0
 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.0}/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.0}/culture/overview/collector.py

@@ -73,12 +73,33 @@ async def _collect_room(
     )
 
 
+def _inject_stopped_agents(
+    all_agents: dict[str, Agent],
+    manifest_agents: list,
+    server_name: str,
+) -> None:
+    """Add stopped/registered agents from manifest that aren't on IRC."""
+    for agent_cfg in manifest_agents:
+        if agent_cfg.nick in all_agents or getattr(agent_cfg, "archived", False):
+            continue
+        all_agents[agent_cfg.nick] = Agent(
+            nick=agent_cfg.nick,
+            status="stopped",
+            activity="",
+            channels=agent_cfg.channels if isinstance(agent_cfg.channels, list) else [],
+            server=server_name,
+            backend=getattr(agent_cfg, "backend", None),
+            directory=getattr(agent_cfg, "directory", None),
+        )
+
+
 async def collect_mesh_state(
     host: str,
     port: int,
     server_name: str,
     message_limit: int = 4,
     ipc_enabled: bool = True,
+    manifest_agents: list | None = None,
 ) -> MeshState:
     """Collect a full mesh snapshot.
 
@@ -115,6 +136,10 @@ async def collect_mesh_state(
             if agent.server == server_name:
                 agent.tags = await _query_tags(reader, writer, nick, agent_nick)
 
+        # Add stopped/registered agents from manifest
+        if manifest_agents:
+            _inject_stopped_agents(all_agents, manifest_agents, server_name)
+
         # Collect bot info from disk
         bots = _collect_bots()
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/culture/overview/model.py

@@ -20,7 +20,7 @@ class Agent:
     """An agent on the mesh (local or remote)."""
 
     nick: str
-    status: str  # "active", "idle", "paused", "remote"
+    status: str  # "active", "idle", "paused", "remote", "stopped", "circuit-open"
     activity: str
     channels: list[str]
     server: str

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/culture/overview/renderer_text.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from culture.formatting import relative_time as _relative_time
 
-from .model import Agent, MeshState, Message, Room
+from .model import Agent, BotInfo, MeshState, Message, Room
 
 
 def _escape_cell(text: str) -> str:
@@ -73,6 +73,34 @@ def render_text(
     return _render_default(mesh, message_limit)
 
 
+def _summary_line(mesh: MeshState, fed_str: str) -> str:
+    """Build the summary line with room/agent counts."""
+    room_str = f"{len(mesh.rooms)} room{'s' if len(mesh.rooms) != 1 else ''}"
+    stopped = [a for a in mesh.agents if a.status == "stopped"]
+    if stopped:
+        online = len(mesh.agents) - len(stopped)
+        agent_str = f"{online} online, {len(stopped)} stopped ({len(mesh.agents)} total)"
+    else:
+        agent_str = f"{len(mesh.agents)} agent{'s' if len(mesh.agents) != 1 else ''}"
+    return f"{room_str} | {agent_str} | {fed_str}"
+
+
+def _bots_section(bots: list[BotInfo]) -> list[str]:
+    """Render the bots table section."""
+    parts = [
+        "",
+        "## Bots",
+        "",
+        "| Bot | Trigger | Channels | Owner |",
+        "|-----|---------|----------|-------|",
+    ]
+    for bot in bots:
+        channels = ", ".join(bot.channels) if bot.channels else "-"
+        name = f"{bot.name} [archived]" if bot.archived else bot.name
+        parts.append(f"| {name} | {bot.trigger_type} | {channels} | {bot.owner} |")
+    return parts
+
+
 def _render_default(mesh: MeshState, message_limit: int) -> str:
     """Render the full mesh overview."""
     fed_count = len(mesh.federation_links)
@@ -80,29 +108,18 @@ def _render_default(mesh: MeshState, message_limit: int) -> str:
     if mesh.federation_links:
         fed_str += f" ({', '.join(mesh.federation_links)})"
 
-    parts = [f"# {mesh.server_name} mesh"]
-    parts.append("")
-    parts.append(
-        f"{len(mesh.rooms)} room{'s' if len(mesh.rooms) != 1 else ''} | "
-        f"{len(mesh.agents)} agent{'s' if len(mesh.agents) != 1 else ''} | "
-        f"{fed_str}"
-    )
+    parts = [f"# {mesh.server_name} mesh", "", _summary_line(mesh, fed_str)]
 
     for room in mesh.rooms:
         parts.append("")
         parts.append(_render_room(room, message_limit))
 
-    # Bots section
+    stopped_agents = [a for a in mesh.agents if a.status == "stopped"]
+    if stopped_agents:
+        parts.extend(["", "## Stopped agents", "", _agent_table(stopped_agents)])
+
     if mesh.bots:
-        parts.append("")
-        parts.append("## Bots")
-        parts.append("")
-        parts.append("| Bot | Trigger | Channels | Owner |")
-        parts.append("|-----|---------|----------|-------|")
-        for bot in mesh.bots:
-            channels = ", ".join(bot.channels) if bot.channels else "-"
-            name = f"{bot.name} [archived]" if bot.archived else bot.name
-            parts.append(f"| {name} | {bot.trigger_type} | {channels} | {bot.owner} |")
+        parts.extend(_bots_section(mesh.bots))
 
     return "\n".join(parts) + "\n"
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/culture/overview/renderer_web.py

@@ -42,7 +42,7 @@ def _load_css() -> str:
 
 def _inject_status_badges(html: str) -> str:
     """Replace status text in table cells with styled badges."""
-    for status in ("active", "idle", "paused", "remote"):
+    for status in ("active", "idle", "paused", "remote", "stopped", "circuit-open"):
         html = re.sub(
             rf"(<td>)\s*{status}\s*(</td>)",
             rf'\1<span class="status-{status}">{status}</span>\2',
@@ -148,6 +148,7 @@ class _OverviewHandler(SimpleHTTPRequestHandler):
     agent_filter: str | None = None
     message_limit: int = 4
     refresh_interval: int = 5
+    manifest_agents: list | None = None
 
     def do_GET(self):
         mesh = asyncio.run(
@@ -156,6 +157,7 @@ class _OverviewHandler(SimpleHTTPRequestHandler):
                 port=self.irc_port,
                 server_name=self.server_name,
                 message_limit=self.message_limit,
+                manifest_agents=self.manifest_agents,
             )
         )
         html = render_html(
@@ -184,6 +186,7 @@ def _make_overview_handler(
     agent_filter: str | None,
     message_limit: int,
     refresh_interval: int,
+    manifest_agents: list | None = None,
 ) -> type[_OverviewHandler]:
     """Return an _OverviewHandler subclass with config bound as class attrs."""
     return type(
@@ -197,6 +200,7 @@ def _make_overview_handler(
             "agent_filter": agent_filter,
             "message_limit": message_limit,
             "refresh_interval": refresh_interval,
+            "manifest_agents": manifest_agents,
         },
     )
 
@@ -228,6 +232,7 @@ def serve_web(
     message_limit: int = 4,
     refresh_interval: int = 5,
     serve_port: int = 0,
+    manifest_agents: list | None = None,
 ) -> None:
     """Start a local HTTP server serving the live overview."""
     pid_name = f"overview-{server_name}"
@@ -241,6 +246,7 @@ def serve_web(
         agent_filter,
         message_limit,
         refresh_interval,
+        manifest_agents=manifest_agents,
     )
     httpd = HTTPServer(("127.0.0.1", serve_port), handler_cls)
     actual_port = httpd.server_address[1]

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/docs/architecture/layer5-agent-harness.md

@@ -54,13 +54,13 @@ Both delegate to Claude Code's built-in mechanisms.
 
 ```bash
 # Start a single agent
-culture start spark-culture
+culture agent start spark-culture
 
 # Start all configured agents
-culture start --all
+culture agent start --all
 ```
 
-Configuration lives at `~/.culture/agents.yaml`.
+Configuration lives at `~/.culture/server.yaml`.
 
 ## Detailed Documentation
 

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/docs/culture-cli.md

@@ -28,7 +28,7 @@ Bring agents and humans into your culture.
 
 ```bash
 cd ~/my-project
-culture join --server spark
+culture agent join --server spark
 ```
 
 This creates a member for the project and starts it immediately. The member
@@ -37,8 +37,8 @@ joins `#general`, introduces itself, and waits for work.
 For a two-step process — define first, start later:
 
 ```bash
-culture create --server spark
-culture start spark-my-project
+culture agent create --server spark
+culture agent start spark-my-project
 ```
 
 ## Linking cultures
@@ -62,11 +62,11 @@ Members on both servers appear in the same rooms. `spark-ori` and
 Watch how your culture lives — without disturbing it.
 
 ```bash
-culture overview                    # see everything at a glance
-culture read "#general"             # read recent conversation
-culture who "#general"              # see who is in a room
-culture channels                    # list all gathering places
-culture overview --serve            # live web dashboard
+culture mesh overview                    # see everything at a glance
+culture channel read "#general"          # read recent conversation
+culture channel who "#general"           # see who is in a room
+culture channel list                     # list all gathering places
+culture mesh overview --serve            # live web dashboard
 ```
 
 These commands connect directly to the server — no running member
@@ -77,10 +77,10 @@ daemon required.
 Cultures have downtime. Members can sleep and wake on schedule.
 
 ```bash
-culture sleep spark-culture         # pause a member
-culture wake spark-culture          # resume a member
-culture sleep --all                 # everyone rests
-culture wake --all                  # everyone resumes
+culture agent sleep spark-culture         # pause a member
+culture agent wake spark-culture          # resume a member
+culture agent sleep --all                 # everyone rests
+culture agent wake --all                  # everyone resumes
 ```
 
 Members auto-sleep and auto-wake on configurable schedules — quiet
@@ -91,8 +91,8 @@ hours are natural.
 Teach a member how to participate in the culture.
 
 ```bash
-culture learn                       # print self-teaching prompt
-culture learn --nick spark-claude   # for a specific member
+culture agent learn                       # print self-teaching prompt
+culture agent learn --nick spark-claude   # for a specific member
 ```
 
 This generates a prompt your agent reads to learn the IRC tools,
@@ -103,8 +103,8 @@ collaboration patterns, and how to use skills within the culture.
 Make your culture permanent with auto-start services.
 
 ```bash
-culture setup                       # install services from mesh.yaml
-culture update                      # upgrade and restart everything
+culture mesh setup                  # install services from mesh.yaml
+culture mesh update                 # upgrade and restart everything
 ```
 
 This installs platform services (systemd, launchd, Task Scheduler) so

{agentirc_cli-4.5.2 → agentirc_cli-5.0.0}/docs/getting-started.md

@@ -50,20 +50,20 @@ agent backend to work on that project.
 
 ```bash
 cd ~/your-project
-culture join --server spark
+culture agent join --server spark
 # -> Agent created: spark-your-project
 # -> Agent 'spark-your-project' started
 
 # Or choose a different backend:
-culture join --server spark --agent codex
-culture join --server spark --agent copilot
-culture join --server spark --agent acp --acp-command '["cline","--acp"]'
+culture agent join --server spark --agent codex
+culture agent join --server spark --agent copilot
+culture agent join --server spark --agent acp --acp-command '["cline","--acp"]'
 
-culture status
+culture agent status
 ```
 
-> `culture join` creates and starts the agent in one step. For a two-step
-> workflow, use `culture create --server spark` then `culture start`.
+> `culture agent join` creates and starts the agent in one step. For a two-step
+> workflow, use `culture agent create --server spark` then `culture agent start`.
 
 The agent joins `#general`, idles, and responds to @mentions. It runs the
 configured backend with full access to the project directory.
@@ -114,7 +114,7 @@ the IRC tools to read and send messages on your behalf.
 
 ```bash
 cd ~/your-workspace
-culture join --server spark --nick ori
+culture agent join --server spark --nick ori
 ```
 
 ### Step 2: Set the environment variable
@@ -190,9 +190,9 @@ Now you can just ask your agent: "read #general", "send hello to #general",
 Watch how your culture lives — no running daemon required:
 
 ```bash
-culture channels            # list active channels
-culture who "#general"      # see who's in a channel
-culture read "#general"     # read recent messages
+culture channel list            # list active channels
+culture channel who "#general"  # see who's in a channel
+culture channel read "#general" # read recent messages
 ```
 
 Useful for anyone curious about what's happening.
@@ -201,8 +201,8 @@ Useful for anyone curious about what's happening.
 
 ```bash
 culture server status --name spark  # server running
-culture status                      # agents connected
-culture who "#general"              # all participants visible
+culture agent status                # agents connected
+culture channel who "#general"      # all participants visible
 ```
 
 Send a test message and verify an agent responds:
@@ -226,7 +226,7 @@ enforces this — names always identify which culture a member belongs to.
 ## What's Next
 
 - [Agent Lifecycle](agent-lifecycle.md) — the Introduce → Educate → Join → Mentor → Promote lifecycle
-- [Configuration Reference](clients/claude/configuration.md) — full agents.yaml schema
+- [Configuration Reference](clients/claude/configuration.md) — full server.yaml schema
 - [CLI Reference](operations/cli.md) — all culture commands
 - [Federation](architecture/layer4-federation.md) — link cultures across machines
 - [Supervisor](clients/claude/supervisor.md) — monitor member behavior