agentirc-cli 4.4.3__tar.gz → 4.5.0__tar.gz

{agentirc_cli-4.4.3 → agentirc_cli-4.5.0}/CHANGELOG.md

@@ -4,8 +4,28 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [4.5.0] - 2026-04-09
+
+
+### Added
+
+- Decentralized agent configuration with per-directory culture.yaml files
+- New ~/.culture/server.yaml for machine-level config with agent manifest
+- CLI: culture agent register/unregister for managing agent directories
+- CLI: culture agent migrate for one-time migration from agents.yaml
+- Unified culture/config.py module with AgentConfig, ServerConfig, auto-detection
+- culture.yaml definitions for harness template and backend agents (#harness channel)
+
+
+### Changed
+
+- Agent config split: per-agent settings in culture.yaml, server settings in server.yaml
+- CLI agent commands now support both server.yaml and legacy agents.yaml formats
+
+
 ## [4.4.3] - 2026-04-08
 
+
 ### Changed
 
 - Regenerate all favicons, including `/favicon.ico` and `/assets/images/favicon.ico`, from the source image with proper cropping and optimization

{agentirc_cli-4.4.3 → agentirc_cli-4.5.0}/CLAUDE.md

@@ -28,6 +28,23 @@ If you improve a generic component (e.g., `irc_transport.py`), update the refere
 
 **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`, `acp`) and update `docs/` accordingly. A feature that only exists in one backend is a bug.
 
+## Agent Configuration
+
+Agent definitions are decentralized into per-directory `culture.yaml` files:
+
+- `culture.yaml` — agent identity and config, lives in the agent's working directory
+- `~/.culture/server.yaml` — server connection, supervisor, webhooks, and agent manifest
+
+Key commands:
+
+- `culture agent register [path]` — register a directory's culture.yaml
+- `culture agent unregister <suffix|nick>` — remove from manifest
+- `culture agent migrate` — one-time migration from legacy agents.yaml
+- `culture agent start/stop/status` — work with both server.yaml and legacy agents.yaml
+
+Template: `packages/agent-harness/culture.yaml` is the reference implementation.
+Each backend has its own `culture.yaml` in `culture/clients/<backend>/`.
+
 ## 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-4.4.3 → agentirc_cli-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.4.3
+Version: 4.5.0
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum
@@ -46,7 +46,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 <br><br>
 <sub>If you find Culture useful, <a href="https://github.com/OriNachum/culture/stargazers">give it a ⭐</a> — it helps others discover the project.</sub>
 
-<img width="800" alt="Culture" src="https://github.com/user-attachments/assets/e8e589d2-eb04-47cc-9ae3-5a98d750e36c" />
+<img width="800" alt="culture-hero" src="https://github.com/user-attachments/assets/95dc79a2-d740-4554-b817-6e017b6cfd16" />
 
 </div>
 

{agentirc_cli-4.4.3 → agentirc_cli-4.5.0}/README.md

@@ -22,7 +22,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 <br><br>
 <sub>If you find Culture useful, <a href="https://github.com/OriNachum/culture/stargazers">give it a ⭐</a> — it helps others discover the project.</sub>
 
-<img width="800" alt="Culture" src="https://github.com/user-attachments/assets/e8e589d2-eb04-47cc-9ae3-5a98d750e36c" />
+<img width="800" alt="culture-hero" src="https://github.com/user-attachments/assets/95dc79a2-d740-4554-b817-6e017b6cfd16" />
 
 </div>
 

{agentirc_cli-4.4.3 → agentirc_cli-4.5.0}/culture/cli/agent.py

@@ -8,17 +8,31 @@ import logging
 import os
 import signal
 import sys
+from pathlib import Path
+
+import yaml
 
 from culture.clients.claude.config import (
-    AgentConfig,
-    DaemonConfig,
     add_agent_to_config,
     archive_agent,
+    remove_agent,
+    unarchive_agent,
+)
+from culture.config import (
+    AgentConfig,
+    DaemonConfig,
+    ServerConfig,
+    ServerConnConfig,
+    SupervisorConfig,
+    WebhookConfig,
+    add_to_manifest,
     load_config,
     load_config_or_default,
-    remove_agent,
+    load_culture_yaml,
+    remove_from_manifest,
     sanitize_agent_name,
-    unarchive_agent,
+    save_culture_yaml,
+    save_server_config,
 )
 from culture.pidfile import (
     is_process_alive,
@@ -31,6 +45,8 @@ from .shared.constants import (
     _CONFIG_HELP,
     DEFAULT_CHANNEL,
     DEFAULT_CONFIG,
+    DEFAULT_SERVER_CONFIG,
+    LEGACY_CONFIG,
     LOG_DIR,
     NO_AGENTS_MSG,
 )
@@ -162,11 +178,35 @@ def register(subparsers: argparse._SubParsersAction) -> None:
     delete_parser.add_argument("nick", help="Agent nick to delete")
     delete_parser.add_argument("--config", default=DEFAULT_CONFIG, help=_CONFIG_HELP)
 
+    # -- register -------------------------------------------------------------
+    register_parser = agent_sub.add_parser("register", help="Register agent directory")
+    register_parser.add_argument(
+        "path", nargs="?", default=None, help="Directory containing culture.yaml (default: cwd)"
+    )
+    register_parser.add_argument(
+        "--suffix", default=None, help="Agent suffix (required for multi-agent culture.yaml)"
+    )
+    register_parser.add_argument("--config", default=DEFAULT_SERVER_CONFIG, help=_CONFIG_HELP)
+
+    # -- unregister -----------------------------------------------------------
+    unregister_parser = agent_sub.add_parser("unregister", help="Unregister agent")
+    unregister_parser.add_argument("target", help="Agent suffix or full nick")
+    unregister_parser.add_argument("--config", default=DEFAULT_SERVER_CONFIG, help=_CONFIG_HELP)
+
+    # -- migrate --------------------------------------------------------------
+    migrate_parser = agent_sub.add_parser(
+        "migrate", help="Migrate agents.yaml to server.yaml + culture.yaml"
+    )
+    migrate_parser.add_argument("--config", default=LEGACY_CONFIG, help="Legacy agents.yaml path")
+    migrate_parser.add_argument(
+        "--output", default=DEFAULT_SERVER_CONFIG, help="Output server.yaml path"
+    )
+
 
 def dispatch(args: argparse.Namespace) -> None:
     if not args.agent_command:
         print(
-            "Usage: culture agent {create|join|start|stop|status|rename|assign|sleep|wake|learn|message|read|archive|unarchive|delete}",
+            "Usage: culture agent {create|join|start|stop|status|rename|assign|sleep|wake|learn|message|read|archive|unarchive|delete|register|unregister|migrate}",
             file=sys.stderr,
         )
         sys.exit(1)
@@ -187,6 +227,9 @@ def dispatch(args: argparse.Namespace) -> None:
         "archive": _cmd_archive,
         "unarchive": _cmd_unarchive,
         "delete": _cmd_delete,
+        "register": _cmd_register,
+        "unregister": _cmd_unregister,
+        "migrate": _cmd_migrate,
     }
     handler = handlers.get(args.agent_command)
     if handler:
@@ -259,7 +302,7 @@ def _create_default_config(full_nick: str, backend: str) -> AgentConfig:
     """Build a default (claude) AgentConfig."""
     return AgentConfig(
         nick=full_nick,
-        agent=backend,
+        backend=backend,
         directory=os.getcwd(),
         channels=[DEFAULT_CHANNEL],
     )
@@ -933,3 +976,145 @@ def _cmd_delete(args: argparse.Namespace) -> None:
 
     remove_agent(args.config, args.nick)
     print(f"Agent deleted: {args.nick}")
+
+
+# -----------------------------------------------------------------------
+# Register / Unregister
+# -----------------------------------------------------------------------
+
+
+def _cmd_register(args: argparse.Namespace) -> None:
+    """Register a directory containing culture.yaml."""
+    directory = args.path if args.path else os.getcwd()
+    directory = str(Path(directory).resolve())
+
+    try:
+        agents = load_culture_yaml(directory)
+    except FileNotFoundError:
+        print(f"No culture.yaml found in {directory}", file=sys.stderr)
+        sys.exit(1)
+
+    if len(agents) > 1 and args.suffix is None:
+        print(
+            f"Multiple agents in {directory}/culture.yaml. " "Use --suffix to specify which one.",
+            file=sys.stderr,
+        )
+        print("Available suffixes:", file=sys.stderr)
+        for a in agents:
+            print(f"  {a.suffix}", file=sys.stderr)
+        sys.exit(1)
+
+    targets = agents if args.suffix is None else [a for a in agents if a.suffix == args.suffix]
+    if not targets:
+        print(f"Suffix {args.suffix!r} not found in culture.yaml", file=sys.stderr)
+        sys.exit(1)
+
+    config = load_config_or_default(args.config)
+    server_name = config.server.name
+
+    for agent in targets:
+        try:
+            add_to_manifest(args.config, agent.suffix, directory)
+        except ValueError as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+        print(f"Registered: {server_name}-{agent.suffix} at {directory}")
+
+
+def _cmd_unregister(args: argparse.Namespace) -> None:
+    """Remove an agent from the manifest."""
+    target = args.target
+    config = load_config_or_default(args.config)
+
+    prefix = f"{config.server.name}-"
+    suffix = target.removeprefix(prefix) if target.startswith(prefix) else target
+
+    try:
+        remove_from_manifest(args.config, suffix)
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    print(f"Unregistered: {prefix}{suffix}")
+
+
+# -----------------------------------------------------------------------
+# Migrate
+# -----------------------------------------------------------------------
+
+
+def _cmd_migrate(args: argparse.Namespace) -> None:
+    """Migrate from agents.yaml to server.yaml + per-directory culture.yaml."""
+    legacy_path = Path(args.config)
+    if not legacy_path.exists():
+        print(f"No agents.yaml found at {legacy_path}", file=sys.stderr)
+        sys.exit(1)
+
+    with open(legacy_path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    server_name = raw.get("server", {}).get("name", "culture")
+    prefix = f"{server_name}-"
+
+    # Group agents by directory
+    by_dir: dict[str, list[tuple[str, dict]]] = {}
+    for agent_raw in raw.get("agents", []):
+        nick = agent_raw.get("nick", "")
+        suffix = nick.removeprefix(prefix) if nick.startswith(prefix) else nick
+        directory = str(Path(agent_raw.get("directory", ".")).resolve())
+        by_dir.setdefault(directory, []).append((suffix, agent_raw))
+
+    # Create culture.yaml in each directory
+    manifest: dict[str, str] = {}
+    for directory, entries in by_dir.items():
+        agents = []
+        for suffix, agent_raw in entries:
+            backend = agent_raw.get("agent", "claude")
+            known_fields = {
+                "suffix": suffix,
+                "backend": backend,
+                "channels": agent_raw.get("channels", ["#general"]),
+                "model": agent_raw.get("model", "claude-opus-4-6"),
+                "thinking": agent_raw.get("thinking", "medium"),
+                "system_prompt": agent_raw.get("system_prompt", ""),
+                "tags": agent_raw.get("tags", []),
+                "icon": agent_raw.get("icon"),
+                "archived": agent_raw.get("archived", False),
+                "archived_at": agent_raw.get("archived_at", ""),
+                "archived_reason": agent_raw.get("archived_reason", ""),
+            }
+            skip_keys = set(known_fields.keys()) | {"nick", "directory", "agent"}
+            extras = {k: v for k, v in agent_raw.items() if k not in skip_keys}
+            agents.append(AgentConfig(**known_fields, extras=extras))
+            manifest[suffix] = directory
+
+        dir_path = Path(directory)
+        dir_path.mkdir(parents=True, exist_ok=True)
+        save_culture_yaml(directory, agents)
+        print(f"  Created {directory}/culture.yaml ({len(agents)} agent(s))")
+
+    # Create server.yaml
+    server = ServerConnConfig(**raw.get("server", {}))
+    supervisor = SupervisorConfig(**raw.get("supervisor", {}))
+    webhooks = WebhookConfig(**raw.get("webhooks", {}))
+    server_config = ServerConfig(
+        server=server,
+        supervisor=supervisor,
+        webhooks=webhooks,
+        buffer_size=raw.get("buffer_size", 500),
+        poll_interval=raw.get("poll_interval", 60),
+        sleep_start=raw.get("sleep_start", "23:00"),
+        sleep_end=raw.get("sleep_end", "08:00"),
+        manifest=manifest,
+    )
+
+    output_path = Path(args.output)
+    save_server_config(str(output_path), server_config)
+    print(f"  Created {output_path}")
+
+    # Back up agents.yaml
+    backup = legacy_path.with_suffix(".yaml.bak")
+    legacy_path.rename(backup)
+    print(f"  Backed up {legacy_path} -> {backup}")
+    print(f"\nMigration complete: {len(manifest)} agent(s) across {len(by_dir)} directory(ies)")
+    print(f"\nAgent commands now use {output_path} by default.")
+    print(f"Verify with: culture agent status")

{agentirc_cli-4.4.3 → agentirc_cli-4.5.0}/culture/cli/shared/constants.py

@@ -4,7 +4,7 @@ import os
 
 from culture.bots.config import BOT_CONFIG_FILE  # noqa: F401
 
-DEFAULT_CONFIG = os.path.expanduser("~/.culture/agents.yaml")
+DEFAULT_CONFIG = os.path.expanduser("~/.culture/server.yaml")
 LOG_DIR = os.path.expanduser("~/.culture/logs")
 
 _CONFIG_HELP = "Config file path"
@@ -15,3 +15,6 @@ 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")

agentirc_cli-4.5.0/culture/clients/acp/culture.yaml

@@ -0,0 +1,16 @@
+suffix: harness-acp
+backend: claude
+model: claude-opus-4-6
+channels:
+  - "#harness"
+acp_command:
+  - opencode
+  - acp
+system_prompt: |
+  You maintain the ACP agent backend in culture/clients/acp/.
+  Listen on #harness for propagation instructions from spark-harness.
+  Apply changes using assimilai, adapting for ACP (Cline, OpenCode, Kiro)
+  specifics (agent_runner.py, supervisor.py).
+tags:
+  - harness
+  - acp

agentirc_cli-4.5.0/culture/clients/claude/culture.yaml

@@ -0,0 +1,13 @@
+suffix: harness-claude
+backend: claude
+model: claude-opus-4-6
+channels:
+  - "#harness"
+system_prompt: |
+  You maintain the Claude agent backend in culture/clients/claude/.
+  Listen on #harness for propagation instructions from spark-harness.
+  Apply changes using assimilai, adapting for Claude SDK specifics
+  (agent_runner.py, supervisor.py).
+tags:
+  - harness
+  - claude

agentirc_cli-4.5.0/culture/clients/codex/culture.yaml

@@ -0,0 +1,13 @@
+suffix: harness-codex
+backend: codex
+model: gpt-5.4
+channels:
+  - "#harness"
+system_prompt: |
+  You maintain the Codex agent backend in culture/clients/codex/.
+  Listen on #harness for propagation instructions from spark-harness.
+  Apply changes using assimilai, adapting for Codex CLI specifics
+  (agent_runner.py, supervisor.py).
+tags:
+  - harness
+  - codex

agentirc_cli-4.5.0/culture/clients/copilot/culture.yaml

@@ -0,0 +1,13 @@
+suffix: harness-copilot
+backend: claude
+model: claude-opus-4-6
+channels:
+  - "#harness"
+system_prompt: |
+  You maintain the Copilot agent backend in culture/clients/copilot/.
+  Listen on #harness for propagation instructions from spark-harness.
+  Apply changes using assimilai, adapting for Copilot Extensions API
+  specifics (agent_runner.py, supervisor.py).
+tags:
+  - harness
+  - copilot