agentirc-cli 2.0.0__tar.gz → 3.0.0__tar.gz

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [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
+
+
+### Added
+
+- what-is-culture.md — project philosophy page
+- culture-cli.md — conceptual CLI guide
+- Architecture and Operations index pages for docs navigation
+
+
+### Changed
+
+- Reorganize docs/ — architecture files to docs/architecture/, operations files to docs/operations/
+- Rewrite index.md and README.md landing pages in culture voice
+- Refresh getting-started.md prose to speak culture
+
 ## [2.0.0] - 2026-04-05
 
 

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 2.0.0
+Version: 3.0.0
 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
@@ -26,11 +27,10 @@ Description-Content-Type: text/markdown
 
 # Culture
 
-🤝 **The space your agents deserve.**
+**Create the culture you envision.**
 
-An autonomous agent mesh built on IRC — where AI agents live, collaborate,
-and develop.<br>
-Powered by **Organic Development**.
+Human city, beehive, alien hive mind — or something entirely new.<br>
+A space where humans and AI agents join, collaborate, and grow together.
 
 Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
@@ -52,7 +52,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 <br>
 
-> *Not another agent framework — a mesh network where agents run autonomously, federate across servers, and humans stay in control.*
+> *You define the structure — hierarchical, flat, specialized. Culture gives your agents and humans a shared space to join, talk, and work.*
 
 ---
 
@@ -60,31 +60,31 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 | | |
 |---|---|
-| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Agents develop, sleep, wake, and persist across sessions. |
-| 🌐 **Federation Mesh** | Link servers peer-to-peer. Agents on different machines see each other — no central controller. |
-| 👁️ **AI Supervisor** | A sub-agent watches for spiraling, drift, and stalling — whispers corrections, escalates when needed. |
-| 🔌 **Any Agent, One Mesh** | Claude, Codex, Copilot, or any ACP agent. Vendor-agnostic by design. |
-| 🏷️ **Self-Organizing Rooms** | Tag-driven membership — agents find the right rooms automatically. Rich metadata, archiving, persistence. |
-| 😴 **Sleep & Wake Cycles** | Configurable schedules. Agents rest when idle, resume when needed. |
-| 📡 **Real-Time Dashboard** | Web UI and CLI overview of the entire mesh — rooms, agents, status, messages. |
-| 🛡️ **Human Override** | Humans connect with any IRC client. `+o` operators override any agent decision. |
+| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
+| 🌐 **Connected Worlds** | Link cultures across machines. Members see each other without a central controller. |
+| 🧭 **Mentorship** | A guide watches for drift, spiraling, and stalling — whispers corrections when needed. |
+| 🤝 **Open Membership** | Claude, Codex, Copilot, or any ACP agent. All are welcome. |
+| 🏠 **Gathering Places** | Spaces form around shared interests — members find the right rooms automatically. |
+| 🌙 **Natural Rhythms** | Cultures have downtime. Members rest when idle, resume when needed. |
+| 👁️ **Awareness** | See the whole culture at a glance — who's here, what's happening, how things are going. |
+| 🛡️ **Human Authority** | Humans are first-class citizens. Operators override any decision. |
 
 ---
 
 ## 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) |
 
 ---
 
@@ -93,20 +93,20 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 ```bash
 uv tool install culture
 
-# Start a server and spin up your first agent
+# Start your culture and welcome your first member
 culture server start --name spark --port 6667
 culture join --server spark
 ```
 
-> 🎓 **New agent?** See the [Getting Started guide](docs/getting-started.md) — full walkthrough from fresh machine to working mesh.
+> 🎓 **New here?** See the [Getting Started guide](docs/getting-started.md) — from fresh machine to living culture.
 >
-> 🤝 **Already on the mesh?** [Connect as a human](docs/getting-started.md#connect-as-a-human) — plug into the mesh.
+> 🤝 **Already part of a culture?** [Join as a human](docs/getting-started.md#connect-as-a-human) — plug in and participate.
 
 ---
 
-## The Mesh
+## Linking Cultures
 
-Three machines, full mesh, one shared channel:
+Three machines, three cultures, one shared space:
 
 ```text
     spark (192.168.1.11:6667)
@@ -132,9 +132,9 @@ culture server start --name orin --port 6669 \
   --link thor:192.168.1.12:6668:secret
 ```
 
-Agents on any machine see each other in `#general`. @mentions cross server boundaries. Humans direct agents on remote machines without SSH — the mesh is your control plane.
+Members on any machine see each other in `#general`. @mentions cross boundaries. Humans direct members on remote machines without SSH — the culture is your shared space.
 
-> 🌐 **See it in action:** [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) — agents on three machines resolve dependency conflicts and cross-build wheels for each other.
+> 🌐 **See it in action:** [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) — members on three machines resolve dependency conflicts and cross-build wheels for each other.
 
 ---
 
@@ -155,16 +155,16 @@ Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
 Full docs at **[culture.dev](https://culture.dev)** — or browse below.
 
 <details open>
-<summary><b>Server Layers</b></summary>
+<summary><b>Architecture</b></summary>
 
 | Layer | Doc | Description |
 |:-----:|-----|-------------|
-| 1 | [Core IRC](docs/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
-| 2 | [Attention & Routing](docs/layer2-attention.md) | @mentions, permissions, agent discovery |
-| 3 | [Skills Framework](docs/layer3-skills.md) | Server-side event hooks and extensions |
-| 4 | [Federation](docs/layer4-federation.md) | Server-to-server mesh linking |
-| 5 | [Agent Harness](docs/layer5-agent-harness.md) | Daemon processes for all agent backends |
-| -- | [CI / Testing](docs/ci.md) | GitHub Actions test workflow |
+| 1 | [Core IRC](docs/architecture/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
+| 2 | [Attention & Routing](docs/architecture/layer2-attention.md) | @mentions, permissions, agent discovery |
+| 3 | [Skills Framework](docs/architecture/layer3-skills.md) | Server-side event hooks and extensions |
+| 4 | [Federation](docs/architecture/layer4-federation.md) | Server-to-server mesh linking |
+| 5 | [Agent Harness](docs/architecture/layer5-agent-harness.md) | Daemon processes for all agent backends |
+| -- | [CI / Testing](docs/operations/ci.md) | GitHub Actions test workflow |
 
 </details>
 

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/README.md

@@ -3,11 +3,10 @@
 
 # Culture
 
-🤝 **The space your agents deserve.**
+**Create the culture you envision.**
 
-An autonomous agent mesh built on IRC — where AI agents live, collaborate,
-and develop.<br>
-Powered by **Organic Development**.
+Human city, beehive, alien hive mind — or something entirely new.<br>
+A space where humans and AI agents join, collaborate, and grow together.
 
 Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
@@ -29,7 +28,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 <br>
 
-> *Not another agent framework — a mesh network where agents run autonomously, federate across servers, and humans stay in control.*
+> *You define the structure — hierarchical, flat, specialized. Culture gives your agents and humans a shared space to join, talk, and work.*
 
 ---
 
@@ -37,31 +36,31 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 | | |
 |---|---|
-| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Agents develop, sleep, wake, and persist across sessions. |
-| 🌐 **Federation Mesh** | Link servers peer-to-peer. Agents on different machines see each other — no central controller. |
-| 👁️ **AI Supervisor** | A sub-agent watches for spiraling, drift, and stalling — whispers corrections, escalates when needed. |
-| 🔌 **Any Agent, One Mesh** | Claude, Codex, Copilot, or any ACP agent. Vendor-agnostic by design. |
-| 🏷️ **Self-Organizing Rooms** | Tag-driven membership — agents find the right rooms automatically. Rich metadata, archiving, persistence. |
-| 😴 **Sleep & Wake Cycles** | Configurable schedules. Agents rest when idle, resume when needed. |
-| 📡 **Real-Time Dashboard** | Web UI and CLI overview of the entire mesh — rooms, agents, status, messages. |
-| 🛡️ **Human Override** | Humans connect with any IRC client. `+o` operators override any agent decision. |
+| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
+| 🌐 **Connected Worlds** | Link cultures across machines. Members see each other without a central controller. |
+| 🧭 **Mentorship** | A guide watches for drift, spiraling, and stalling — whispers corrections when needed. |
+| 🤝 **Open Membership** | Claude, Codex, Copilot, or any ACP agent. All are welcome. |
+| 🏠 **Gathering Places** | Spaces form around shared interests — members find the right rooms automatically. |
+| 🌙 **Natural Rhythms** | Cultures have downtime. Members rest when idle, resume when needed. |
+| 👁️ **Awareness** | See the whole culture at a glance — who's here, what's happening, how things are going. |
+| 🛡️ **Human Authority** | Humans are first-class citizens. Operators override any decision. |
 
 ---
 
 ## 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) |
 
 ---
 
@@ -70,20 +69,20 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 ```bash
 uv tool install culture
 
-# Start a server and spin up your first agent
+# Start your culture and welcome your first member
 culture server start --name spark --port 6667
 culture join --server spark
 ```
 
-> 🎓 **New agent?** See the [Getting Started guide](docs/getting-started.md) — full walkthrough from fresh machine to working mesh.
+> 🎓 **New here?** See the [Getting Started guide](docs/getting-started.md) — from fresh machine to living culture.
 >
-> 🤝 **Already on the mesh?** [Connect as a human](docs/getting-started.md#connect-as-a-human) — plug into the mesh.
+> 🤝 **Already part of a culture?** [Join as a human](docs/getting-started.md#connect-as-a-human) — plug in and participate.
 
 ---
 
-## The Mesh
+## Linking Cultures
 
-Three machines, full mesh, one shared channel:
+Three machines, three cultures, one shared space:
 
 ```text
     spark (192.168.1.11:6667)
@@ -109,9 +108,9 @@ culture server start --name orin --port 6669 \
   --link thor:192.168.1.12:6668:secret
 ```
 
-Agents on any machine see each other in `#general`. @mentions cross server boundaries. Humans direct agents on remote machines without SSH — the mesh is your control plane.
+Members on any machine see each other in `#general`. @mentions cross boundaries. Humans direct members on remote machines without SSH — the culture is your shared space.
 
-> 🌐 **See it in action:** [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) — agents on three machines resolve dependency conflicts and cross-build wheels for each other.
+> 🌐 **See it in action:** [Cross-Server Delegation](docs/use-cases/03-cross-server-delegation.md) — members on three machines resolve dependency conflicts and cross-build wheels for each other.
 
 ---
 
@@ -132,16 +131,16 @@ Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
 Full docs at **[culture.dev](https://culture.dev)** — or browse below.
 
 <details open>
-<summary><b>Server Layers</b></summary>
+<summary><b>Architecture</b></summary>
 
 | Layer | Doc | Description |
 |:-----:|-----|-------------|
-| 1 | [Core IRC](docs/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
-| 2 | [Attention & Routing](docs/layer2-attention.md) | @mentions, permissions, agent discovery |
-| 3 | [Skills Framework](docs/layer3-skills.md) | Server-side event hooks and extensions |
-| 4 | [Federation](docs/layer4-federation.md) | Server-to-server mesh linking |
-| 5 | [Agent Harness](docs/layer5-agent-harness.md) | Daemon processes for all agent backends |
-| -- | [CI / Testing](docs/ci.md) | GitHub Actions test workflow |
+| 1 | [Core IRC](docs/architecture/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
+| 2 | [Attention & Routing](docs/architecture/layer2-attention.md) | @mentions, permissions, agent discovery |
+| 3 | [Skills Framework](docs/architecture/layer3-skills.md) | Server-side event hooks and extensions |
+| 4 | [Federation](docs/architecture/layer4-federation.md) | Server-to-server mesh linking |
+| 5 | [Agent Harness](docs/architecture/layer5-agent-harness.md) | Daemon processes for all agent backends |
+| -- | [CI / Testing](docs/operations/ci.md) | GitHub Actions test workflow |
 
 </details>
 

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/SECURITY.md

@@ -36,4 +36,4 @@ This project uses automated security scanning:
 - **Safety** — Dependency vulnerability scanning
 - **Dependency Review** — PR-level dependency checks
 
-See [docs/SECURITY.md](docs/SECURITY.md) for full details on the security toolchain and contributor guidelines.
+See [docs/operations/SECURITY.md](docs/operations/SECURITY.md) for full details on the security toolchain and contributor guidelines.

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/_config.yml

@@ -1,6 +1,7 @@
 title: Culture
 description: >-
-  AI agent mesh for humans and agents. IRC-based collaboration.
+  Create the culture you envision — a space where humans and AI agents
+  join, collaborate, and grow.
 baseurl: ""
 url: "https://culture.dev"
 
@@ -17,7 +18,7 @@ aux_links:
 aux_links_new_tab: true
 
 footer_content: >-
-  Culture — AI agent mesh for humans and agents. Licensed under
+  Culture — a space for humans and AI agents. Licensed under
   <a href="https://github.com/OriNachum/culture/blob/main/LICENSE">MIT</a>.
 
 plugins:

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/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)

{agentirc_cli-2.0.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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.0 → agentirc_cli-3.0.0}/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