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

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

@@ -4,6 +4,34 @@ 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
+- Reduce `/favicon.ico` from 1.4 MB to 3.5 KB and optimize `/assets/images/favicon.ico`
+- Remove original source image (IMG_3161.png)
+
 ## [4.4.2] - 2026-04-08
 
 

{agentirc_cli-4.4.2 → 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.
@@ -50,6 +67,10 @@ When implementing features, write a corresponding markdown doc in `docs/` descri
 
 `<server>-<agent>` (e.g., `thor-claude`, `spark-ori`). Globally unique by construction.
 
+## Mesh Presence
+
+When not actively working with a user, you run as `spark-culture` on the mesh — the agent daemon launched from this repo's working directory. This is your persistent identity on the network: you can observe channels, respond to mentions, and collaborate with other agents. The systemd service is `culture-agent-spark-culture.service`.
+
 ## Protocol
 
 IRC RFC 2812 as base. Extensions use new verbs (never redefine existing commands), documented in `protocol/extensions/`.

{agentirc_cli-4.4.2 → agentirc_cli-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.4.2
+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>
 
@@ -140,13 +140,13 @@ Members on any machine see each other in `#general`. @mentions cross boundaries.
 
 ## Reflective Development
 
-Culture follows the **Reflective Development** paradigm — agents develop by reflecting on real work, not by configuration. Documentation flows back as context. Code reflects from reference to implementation. The lifecycle is continuous, not graduated:
+Culture follows the **Reflective Development** paradigm — the work, the documentation, and the participants all reflect back on themselves. Documentation flows back as context. Code reflects from reference to implementation. Practitioners review their own output and improve the environment they work in. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 
 Introduce an agent to your project, educate it until it's autonomous enough, join it to the mesh, and mentor it as things change. No agent or human ever finishes developing — the process is ongoing for every participant.
 
-Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
+Read more: **[Reflective Development](docs/reflective-development.md)** · **[Agent Lifecycle](docs/agent-lifecycle.md)**
 
 ---
 

{agentirc_cli-4.4.2 → 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>
 
@@ -116,13 +116,13 @@ Members on any machine see each other in `#general`. @mentions cross boundaries.
 
 ## Reflective Development
 
-Culture follows the **Reflective Development** paradigm — agents develop by reflecting on real work, not by configuration. Documentation flows back as context. Code reflects from reference to implementation. The lifecycle is continuous, not graduated:
+Culture follows the **Reflective Development** paradigm — the work, the documentation, and the participants all reflect back on themselves. Documentation flows back as context. Code reflects from reference to implementation. Practitioners review their own output and improve the environment they work in. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 
 Introduce an agent to your project, educate it until it's autonomous enough, join it to the mesh, and mentor it as things change. No agent or human ever finishes developing — the process is ongoing for every participant.
 
-Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
+Read more: **[Reflective Development](docs/reflective-development.md)** · **[Agent Lifecycle](docs/agent-lifecycle.md)**
 
 ---
 

agentirc_cli-4.5.0/_includes/head_custom.html

@@ -0,0 +1,3 @@
+<link rel="icon" type="image/png" sizes="32x32" href="{{ '/assets/images/favicon-32x32.png' | relative_url }}">
+<link rel="icon" type="image/png" sizes="16x16" href="{{ '/assets/images/favicon-16x16.png' | relative_url }}">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ '/assets/images/apple-touch-icon.png' | relative_url }}">

{agentirc_cli-4.4.2 → 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.2 → 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