agentirc-cli 4.2.1__tar.gz → 4.3.0__tar.gz

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [4.3.0] - 2026-04-07
+
+
+### Added
+
+- agent delete command to remove agents from config entirely
+- agent create now overwrites archived agents, enabling harness/model migration
+
+
+### Fixed
+
+- agent create no longer blocks when the matching nick is archived
+
 ## [4.2.1] - 2026-04-07
 
 

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.2.1
+Version: 4.3.0
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/culture/cli/agent.py

@@ -16,6 +16,7 @@ from culture.clients.claude.config import (
     archive_agent,
     load_config,
     load_config_or_default,
+    remove_agent,
     sanitize_agent_name,
     unarchive_agent,
 )
@@ -158,11 +159,16 @@ def register(subparsers: argparse._SubParsersAction) -> None:
     unarchive_parser.add_argument("nick", help="Agent nick to unarchive")
     unarchive_parser.add_argument("--config", default=DEFAULT_CONFIG, help=_CONFIG_HELP)
 
+    # -- delete ---------------------------------------------------------------
+    delete_parser = agent_sub.add_parser("delete", help="Remove an agent from config entirely")
+    delete_parser.add_argument("nick", help="Agent nick to delete")
+    delete_parser.add_argument("--config", default=DEFAULT_CONFIG, help=_CONFIG_HELP)
+
 
 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}",
+            "Usage: culture agent {create|join|start|stop|status|rename|assign|sleep|wake|learn|message|read|archive|unarchive|delete}",
             file=sys.stderr,
         )
         sys.exit(1)
@@ -182,6 +188,7 @@ def dispatch(args: argparse.Namespace) -> None:
         "read": _cmd_read,
         "archive": _cmd_archive,
         "unarchive": _cmd_unarchive,
+        "delete": _cmd_delete,
     }
     handler = handlers.get(args.agent_command)
     if handler:
@@ -264,6 +271,10 @@ def _cmd_create(args: argparse.Namespace) -> None:
 
     for existing in config.agents:
         if existing.nick == full_nick:
+            if existing.archived:
+                print(f"Replacing archived agent '{full_nick}'")
+                remove_agent(args.config, full_nick)
+                break
             channels = existing.channels if isinstance(existing.channels, list) else []
             print(f"Agent '{full_nick}' already exists in config", file=sys.stderr)
             print(f"  Directory: {existing.directory}", file=sys.stderr)
@@ -831,3 +842,20 @@ def _cmd_unarchive(args: argparse.Namespace) -> None:
 
     print(f"Agent unarchived: {args.nick}")
     print(f"\nStart with: culture agent start {args.nick}")
+
+
+def _cmd_delete(args: argparse.Namespace) -> None:
+    """Remove an agent from config entirely."""
+    config = load_config_or_default(args.config)
+    agent = config.get_agent(args.nick)
+    if not agent:
+        print(f"Agent '{args.nick}' not found in config", file=sys.stderr)
+        sys.exit(1)
+
+    # Stop the agent if it's running
+    pid = read_pid(f"agent-{args.nick}")
+    if pid and is_process_alive(pid):
+        stop_agent(args.nick)
+
+    remove_agent(args.config, args.nick)
+    print(f"Agent deleted: {args.nick}")

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/culture/clients/acp/config.py

@@ -248,3 +248,30 @@ def rename_agent(
             return
 
     raise ValueError(f"agent {old_nick!r} not found in config")
+
+
+def remove_agent(
+    path: str | Path,
+    nick: str,
+) -> None:
+    """Remove an agent from config entirely.
+
+    Operates on raw YAML to preserve backend-specific fields on other
+    agents that the typed schema would strip.
+    Raises ValueError if the agent is not found.
+    """
+    path = Path(path)
+    if not path.exists():
+        raise ValueError(f"agent {nick!r} not found in config")
+
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    agents = raw.get("agents", [])
+    for i, agent_raw in enumerate(agents):
+        if agent_raw.get("nick") == nick:
+            agents.pop(i)
+            with open(path, "w") as f:
+                yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
+            return
+    raise ValueError(f"agent {nick!r} not found in config")

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/culture/clients/claude/config.py

@@ -303,6 +303,33 @@ def unarchive_agent(
     raise ValueError(f"agent {nick!r} not found in config")
 
 
+def remove_agent(
+    path: str | Path,
+    nick: str,
+) -> None:
+    """Remove an agent from config entirely.
+
+    Operates on raw YAML to preserve backend-specific fields (e.g.
+    acp_command) on other agents that the typed schema would strip.
+    Raises ValueError if the agent is not found.
+    """
+    path = Path(path)
+    if not path.exists():
+        raise ValueError(f"agent {nick!r} not found in config")
+
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    agents = raw.get("agents", [])
+    for i, agent_raw in enumerate(agents):
+        if agent_raw.get("nick") == nick:
+            agents.pop(i)
+            with open(path, "w") as f:
+                yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
+            return
+    raise ValueError(f"agent {nick!r} not found in config")
+
+
 def archive_server(
     path: str | Path,
     reason: str = "",

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/culture/clients/codex/config.py

@@ -248,3 +248,30 @@ def rename_agent(
             return
 
     raise ValueError(f"agent {old_nick!r} not found in config")
+
+
+def remove_agent(
+    path: str | Path,
+    nick: str,
+) -> None:
+    """Remove an agent from config entirely.
+
+    Operates on raw YAML to preserve backend-specific fields on other
+    agents that the typed schema would strip.
+    Raises ValueError if the agent is not found.
+    """
+    path = Path(path)
+    if not path.exists():
+        raise ValueError(f"agent {nick!r} not found in config")
+
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    agents = raw.get("agents", [])
+    for i, agent_raw in enumerate(agents):
+        if agent_raw.get("nick") == nick:
+            agents.pop(i)
+            with open(path, "w") as f:
+                yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
+            return
+    raise ValueError(f"agent {nick!r} not found in config")

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/culture/clients/copilot/config.py

@@ -248,3 +248,30 @@ def rename_agent(
             return
 
     raise ValueError(f"agent {old_nick!r} not found in config")
+
+
+def remove_agent(
+    path: str | Path,
+    nick: str,
+) -> None:
+    """Remove an agent from config entirely.
+
+    Operates on raw YAML to preserve backend-specific fields on other
+    agents that the typed schema would strip.
+    Raises ValueError if the agent is not found.
+    """
+    path = Path(path)
+    if not path.exists():
+        raise ValueError(f"agent {nick!r} not found in config")
+
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    agents = raw.get("agents", [])
+    for i, agent_raw in enumerate(agents):
+        if agent_raw.get("nick") == nick:
+            agents.pop(i)
+            with open(path, "w") as f:
+                yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
+            return
+    raise ValueError(f"agent {nick!r} not found in config")

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/docs/superpowers/specs/2026-04-07-entity-archiving-design.md

@@ -238,6 +238,58 @@ per-file (no list to search through).
 - `test_start_refuses_archived_server` -- verify error message
 - `test_start_all_skips_archived` -- verify `--all` only starts active agents
 
+## Agent Deletion and Create-Overwrite
+
+### Problem
+
+Once an agent is archived, there's no way to recreate it with a different
+backend or model. `culture agent create` blocks with "already exists in config"
+because the archived entry is still present. Users must manually edit
+`agents.yaml` to change an agent's harness.
+
+### Delete Command
+
+```
+culture agent delete <nick> [--config PATH]
+```
+
+Removes an agent from config entirely. Stops the agent if running.
+
+### Create Overwrites Archived Agents
+
+`culture agent create` now detects when the matching agent is archived and
+automatically replaces it:
+
+```
+$ culture agent archive spark-daria
+Agent archived: spark-daria
+
+$ culture agent create --server spark --nick daria --agent acp
+Replacing archived agent 'spark-daria'
+Agent created: spark-daria
+  ...
+```
+
+Non-archived agents still block `create` with the existing error. This is the
+primary mechanism for moving an agent to a different harness or model.
+
+### Config Layer
+
+```python
+def remove_agent(path, nick):
+    """Remove an agent from config entirely. Raises ValueError if not found."""
+```
+
+Added to all backend config files (`claude`, `acp`, `codex`, `copilot`) and
+`packages/agent-harness/config.py`. Uses raw YAML manipulation to preserve
+backend-specific fields (e.g. `acp_command`) on other agents.
+
+### Protocol Details
+
+No new protocol changes. Delete and create-overwrite are CLI/config operations
+only, consistent with the existing archiving scope (CLI-only, no federation
+concern).
+
 ## Verification
 
 1. Create test agents: `culture agent create --nick test1 && culture agent create --nick test2`

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/packages/agent-harness/config.py

@@ -246,3 +246,30 @@ def rename_agent(
             return
 
     raise ValueError(f"agent {old_nick!r} not found in config")
+
+
+def remove_agent(
+    path: str | Path,
+    nick: str,
+) -> None:
+    """Remove an agent from config entirely.
+
+    Operates on raw YAML to preserve backend-specific fields on other
+    agents that the typed schema would strip.
+    Raises ValueError if the agent is not found.
+    """
+    path = Path(path)
+    if not path.exists():
+        raise ValueError(f"agent {nick!r} not found in config")
+
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    agents = raw.get("agents", [])
+    for i, agent_raw in enumerate(agents):
+        if agent_raw.get("nick") == nick:
+            agents.pop(i)
+            with open(path, "w") as f:
+                yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
+            return
+    raise ValueError(f"agent {nick!r} not found in config")

{agentirc_cli-4.2.1 → agentirc_cli-4.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentirc-cli"
-version = "4.2.1"
+version = "4.3.0"
 description = "Legacy alias for culture — install culture instead"
 readme = "README.md"
 license = "MIT"