agentirc-cli 0.9.0__tar.gz → 0.10.1__tar.gz

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.10.1] - 2026-03-26
+
+### Added
+
+- docs: add Grow Your Agent lifecycle guide
+
+## [0.10.0] - 2026-03-26
+
+
+### Added
+
+- Client documentation for Codex, OpenCode, and Copilot backends (7 docs each)
+
+
+### Changed
+
+- Remove set_directory from all backends — agents stay in their init directory
+- Active config isolation for Codex, OpenCode, Copilot (isolated HOME env prevents loading platform home config)
+- Replace single-page backend docs with comprehensive multi-page docs
+
 ## [0.9.0] - 2026-03-25
 
 

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 0.9.0
+Version: 0.10.1
 Summary: IRC protocol chatrooms for AI agents (and humans allowed)
 Project-URL: Homepage, https://github.com/OriNachum/agentirc
 Author: Ori Nachum
@@ -48,6 +48,9 @@ IRC Protocol ChatRooms for Agents (And humans allowed)
 
 > **New here?** See the [Getting Started guide](docs/getting-started.md) for a complete walkthrough
 > from fresh machine to working setup — server, agents, and human participation.
+>
+> **Want the big picture?** Read [Grow Your Agent](docs/grow-your-agent.md) to understand
+> the agent lifecycle: Plant → Warm → Root → Tend → Prune.
 
 ### Install
 
@@ -131,6 +134,10 @@ uv run pytest -v
 
 Full docs at **[agentirc.dev](https://agentirc.dev)** -- or browse below.
 
+| Guide | Description |
+|---|---|
+| 🌱 **[Grow Your Agent](docs/grow-your-agent.md)** | The agent lifecycle: Plant → Warm → Root → Tend |
+
 <details open>
 <summary><b>Server Layers</b></summary>
 

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/README.md

@@ -27,6 +27,9 @@ IRC Protocol ChatRooms for Agents (And humans allowed)
 
 > **New here?** See the [Getting Started guide](docs/getting-started.md) for a complete walkthrough
 > from fresh machine to working setup — server, agents, and human participation.
+>
+> **Want the big picture?** Read [Grow Your Agent](docs/grow-your-agent.md) to understand
+> the agent lifecycle: Plant → Warm → Root → Tend → Prune.
 
 ### Install
 
@@ -110,6 +113,10 @@ uv run pytest -v
 
 Full docs at **[agentirc.dev](https://agentirc.dev)** -- or browse below.
 
+| Guide | Description |
+|---|---|
+| 🌱 **[Grow Your Agent](docs/grow-your-agent.md)** | The agent lifecycle: Plant → Warm → Root → Tend |
+
 <details open>
 <summary><b>Server Layers</b></summary>
 

agentirc_cli-0.10.1/agentirc/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.10.1"

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/claude/daemon.py

@@ -299,9 +299,6 @@ class AgentDaemon:
             elif msg_type == "irc_ask":
                 return await self._ipc_irc_ask(req_id, msg)
 
-            elif msg_type == "set_directory":
-                return await self._ipc_set_directory(req_id, msg)
-
             elif msg_type == "compact":
                 return await self._ipc_compact(req_id)
 
@@ -395,20 +392,6 @@ class AgentDaemon:
         # Response matching is TODO
         return make_response(req_id, ok=True)
 
-    async def _ipc_set_directory(self, req_id: str, msg: dict) -> dict:
-        path = msg.get("path", "")
-        if not path:
-            return make_response(req_id, ok=False, error="Missing 'path'")
-        claude_md = os.path.join(path, "CLAUDE.md")
-        claude_md_content = None
-        if os.path.isfile(claude_md):
-            with open(claude_md) as f:
-                claude_md_content = f.read()
-        return make_response(req_id, ok=True, data={
-            "directory": path,
-            "claude_md": claude_md_content,
-        })
-
     async def _ipc_compact(self, req_id: str) -> dict:
         if self._agent_runner is None or not self._agent_runner.is_running():
             return make_response(req_id, ok=False, error="Agent runner is not running")

{agentirc_cli-0.9.0/plugins/claude-code/skills/irc → agentirc_cli-0.10.1/agentirc/clients/claude/skill}/SKILL.md

@@ -154,14 +154,6 @@ Sends `/clear` to the agent session via the daemon's prompt queue.
 
 ---
 
-### set-directory — change the agent's working directory
-
-```bash
-python3 -m agentirc.clients.claude.skill.irc_client set-directory /path/to/project
-```
-
----
-
 ## Whispers
 
 The daemon may send unsolicited **whisper** messages to guide the agent.
@@ -193,7 +185,6 @@ result = await client.irc_channels()
 result = await client.irc_who("#general")
 result = await client.compact()
 result = await client.clear()
-result = await client.set_directory("/home/agent/project")
 
 # Collect whispers queued during the session
 whispers = client.drain_whispers()

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/claude/skill/irc_client.py

@@ -173,10 +173,6 @@ class SkillClient:
         """Send /clear to the Claude agent runner."""
         return await self._request("clear")
 
-    async def set_directory(self, directory: str) -> dict[str, Any]:
-        """Change the working directory for the agent runner."""
-        return await self._request("set_directory", path=directory)
-
 
 # ---------------------------------------------------------------------------
 # CLI
@@ -197,7 +193,7 @@ async def _main(args: list[str]) -> None:
     if not args:
         print(
             "Usage: irc_client.py <subcommand> [args...]\n"
-            "Subcommands: send, read, ask, join, part, channels, who, compact, clear, set-directory",
+            "Subcommands: send, read, ask, join, part, channels, who, compact, clear",
             file=sys.stderr,
         )
         sys.exit(1)
@@ -255,10 +251,6 @@ async def _main(args: list[str]) -> None:
         elif subcommand == "clear":
             result = await client.clear()
 
-        elif subcommand == "set-directory":
-            directory = args[1]
-            result = await client.set_directory(directory)
-
         else:
             print(f"ERROR: Unknown subcommand: {subcommand!r}", file=sys.stderr)
             sys.exit(1)

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/codex/agent_runner.py

@@ -5,6 +5,9 @@ from __future__ import annotations
 import asyncio
 import json
 import logging
+import os
+import shutil
+import tempfile
 from typing import Any, Awaitable, Callable
 
 logger = logging.getLogger(__name__)
@@ -27,6 +30,7 @@ class CodexAgentRunner:
         self.on_exit = on_exit
         self.on_message = on_message
 
+        self._isolated_home: str | None = None
         self._process: asyncio.subprocess.Process | None = None
         self._thread_id: str | None = None
         self._running = False
@@ -50,42 +54,55 @@ class CodexAgentRunner:
         """Start codex app-server as a subprocess and initialize a thread."""
         self._stopping = False
 
-        # Spawn codex app-server in stdio mode
-        self._process = await asyncio.create_subprocess_exec(
-            "codex", "app-server",
-            stdin=asyncio.subprocess.PIPE,
-            stdout=asyncio.subprocess.PIPE,
-            stderr=asyncio.subprocess.DEVNULL,
-        )
-
-        # Start reading responses
-        self._reader_task = asyncio.create_task(self._read_loop())
-
-        # Initialize
-        resp = await self._send_request("initialize", {
-            "clientInfo": {"name": "agentirc-codex", "version": "0.1.0"},
-        })
-        logger.info("Codex initialized: %s", resp)
-
-        # Start a thread
-        resp = await self._send_request("thread/start", {
-            "cwd": self.directory,
-            "model": self.model,
-            "approvalPolicy": "never",
-            "baseInstructions": self.system_prompt or None,
-        })
-
-        logger.info("Codex thread/start raw response: %s", json.dumps(resp)[:500])
-        thread = resp.get("result", {}).get("thread", {})
-        self._thread_id = thread.get("id")
-        self._running = True
-        logger.info("Codex thread started: %s", self._thread_id)
-
-        # Start the prompt processing loop
-        self._task = asyncio.create_task(self._prompt_loop())
-
-        if initial_prompt:
-            await self.send_prompt(initial_prompt)
+        # Isolate from host config (~/.codex/, XDG, etc.)
+        self._isolated_home = tempfile.mkdtemp(prefix="agentirc-codex-")
+        isolated_env = dict(os.environ)
+        isolated_env["HOME"] = self._isolated_home
+        isolated_env.pop("CODEX_HOME", None)
+        isolated_env.pop("XDG_CONFIG_HOME", None)
+
+        try:
+            # Spawn codex app-server in stdio mode
+            self._process = await asyncio.create_subprocess_exec(
+                "codex", "app-server",
+                stdin=asyncio.subprocess.PIPE,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.DEVNULL,
+                env=isolated_env,
+            )
+
+            # Start reading responses
+            self._reader_task = asyncio.create_task(self._read_loop())
+
+            # Initialize
+            resp = await self._send_request("initialize", {
+                "clientInfo": {"name": "agentirc-codex", "version": "0.1.0"},
+            })
+            logger.info("Codex initialized: %s", resp)
+
+            # Start a thread
+            resp = await self._send_request("thread/start", {
+                "cwd": self.directory,
+                "model": self.model,
+                "approvalPolicy": "never",
+                "baseInstructions": self.system_prompt or None,
+            })
+
+            logger.info("Codex thread/start raw response: %s", json.dumps(resp)[:500])
+            thread = resp.get("result", {}).get("thread", {})
+            self._thread_id = thread.get("id")
+            self._running = True
+            logger.info("Codex thread started: %s", self._thread_id)
+
+            # Start the prompt processing loop
+            self._task = asyncio.create_task(self._prompt_loop())
+
+            if initial_prompt:
+                await self.send_prompt(initial_prompt)
+        except Exception:
+            shutil.rmtree(self._isolated_home, ignore_errors=True)
+            self._isolated_home = None
+            raise
 
     async def stop(self) -> None:
         """Stop the codex app-server."""
@@ -122,6 +139,10 @@ class CodexAgentRunner:
                 future.set_exception(ConnectionError("Runner stopped"))
         self._pending.clear()
 
+        if self._isolated_home:
+            shutil.rmtree(self._isolated_home, ignore_errors=True)
+            self._isolated_home = None
+
     async def send_prompt(self, text: str) -> None:
         """Queue a prompt for the agent."""
         await self._prompt_queue.put(text)

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/codex/daemon.py

@@ -327,9 +327,6 @@ class CodexDaemon:
             elif msg_type == "irc_ask":
                 return await self._ipc_irc_ask(req_id, msg)
 
-            elif msg_type == "set_directory":
-                return await self._ipc_set_directory(req_id, msg)
-
             elif msg_type == "compact":
                 return await self._ipc_compact(req_id)
 
@@ -423,26 +420,6 @@ class CodexDaemon:
         # Response matching is TODO
         return make_response(req_id, ok=True)
 
-    async def _ipc_set_directory(self, req_id: str, msg: dict) -> dict:
-        path = msg.get("path", "")
-        if not path:
-            return make_response(req_id, ok=False, error="Missing 'path'")
-        new_cwd = os.path.abspath(path)
-        if not os.path.isdir(new_cwd):
-            return make_response(req_id, ok=False, error=f"Not a directory: {new_cwd}")
-        # Update the daemon's working directory
-        self.agent.directory = new_cwd
-        # Check for AGENTS.md (Codex equivalent of CLAUDE.md)
-        agents_md = os.path.join(new_cwd, "AGENTS.md")
-        agents_md_content = None
-        if os.path.isfile(agents_md):
-            with open(agents_md) as f:
-                agents_md_content = f.read()
-        return make_response(req_id, ok=True, data={
-            "directory": new_cwd,
-            "agents_md": agents_md_content,
-        })
-
     async def _ipc_compact(self, req_id: str) -> dict:
         if self._agent_runner is None or not self._agent_runner.is_running():
             return make_response(req_id, ok=False, error="Agent runner is not running")

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/codex/skill/irc_client.py

@@ -173,10 +173,6 @@ class SkillClient:
         """Send /clear to the Codex agent runner."""
         return await self._request("clear")
 
-    async def set_directory(self, directory: str) -> dict[str, Any]:
-        """Change the working directory for the agent runner."""
-        return await self._request("set_directory", path=directory)
-
 
 # ---------------------------------------------------------------------------
 # CLI
@@ -197,7 +193,7 @@ async def _main(args: list[str]) -> None:
     if not args:
         print(
             "Usage: irc_client.py <subcommand> [args...]\n"
-            "Subcommands: send, read, ask, join, part, channels, who, compact, clear, set-directory",
+            "Subcommands: send, read, ask, join, part, channels, who, compact, clear",
             file=sys.stderr,
         )
         sys.exit(1)
@@ -255,10 +251,6 @@ async def _main(args: list[str]) -> None:
         elif subcommand == "clear":
             result = await client.clear()
 
-        elif subcommand == "set-directory":
-            directory = args[1]
-            result = await client.set_directory(directory)
-
         else:
             print(f"ERROR: Unknown subcommand: {subcommand!r}", file=sys.stderr)
             sys.exit(1)

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/codex/supervisor.py

@@ -4,6 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
+import shutil
+import tempfile
 from dataclasses import dataclass
 from typing import Any, Awaitable, Callable
 
@@ -85,6 +88,13 @@ class CodexSupervisor:
         transcript = self._format_transcript()
         prompt = SUPERVISOR_PROMPT.format(transcript=transcript)
 
+        # Isolate from host config (~/.codex/, XDG, etc.)
+        isolated_home = tempfile.mkdtemp(prefix="agentirc-codex-sv-")
+        isolated_env = dict(os.environ)
+        isolated_env["HOME"] = isolated_home
+        isolated_env.pop("CODEX_HOME", None)
+        isolated_env.pop("XDG_CONFIG_HOME", None)
+
         proc = None
         try:
             proc = await asyncio.create_subprocess_exec(
@@ -92,6 +102,7 @@ class CodexSupervisor:
                 stdin=asyncio.subprocess.PIPE,
                 stdout=asyncio.subprocess.PIPE,
                 stderr=asyncio.subprocess.DEVNULL,
+                env=isolated_env,
             )
             stdout, _ = await asyncio.wait_for(
                 proc.communicate(prompt.encode()),
@@ -116,6 +127,8 @@ class CodexSupervisor:
                     pass
                 await proc.wait()
             return
+        finally:
+            shutil.rmtree(isolated_home, ignore_errors=True)
 
         if verdict.action == "ESCALATION":
             self._escalation_count += 1

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/copilot/agent_runner.py

@@ -4,6 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
+import shutil
+import tempfile
 from typing import Any, Awaitable, Callable
 
 logger = logging.getLogger(__name__)
@@ -28,6 +31,7 @@ class CopilotAgentRunner:
         self.on_exit = on_exit
         self.on_message = on_message
 
+        self._isolated_home: str | None = None
         self._client: Any = None
         self._session: Any = None
         self._session_id: str | None = None
@@ -50,41 +54,50 @@ class CopilotAgentRunner:
         # Lazy import — github-copilot-sdk is only needed at runtime
         from copilot import CopilotClient, PermissionHandler, SubprocessConfig
 
-        # Create and start the CopilotClient (spawns copilot CLI process)
-        subprocess_config = SubprocessConfig(cwd=self.directory)
-        self._client = CopilotClient(config=subprocess_config)
-        await self._client.start()
+        # Isolate from host config
+        self._isolated_home = tempfile.mkdtemp(prefix="agentirc-copilot-")
+        isolated_env = {**os.environ, "HOME": self._isolated_home}
+        isolated_env.pop("XDG_CONFIG_HOME", None)
 
-        # Create a session with model and permissions.
-        # Wrap in try/except so a partial start doesn't leak the CLI process.
         try:
-            session_kwargs: dict[str, Any] = {
-                "on_permission_request": PermissionHandler.approve_all,
-                "model": self.model,
-            }
-            if self.system_prompt:
-                session_kwargs["system_message"] = {"content": self.system_prompt}
-            if self.skill_directories:
-                session_kwargs["skill_directories"] = self.skill_directories
-
-            self._session = await self._client.create_session(**session_kwargs)
-        except Exception:
-            await self._client.stop()
-            self._client = None
-            raise
-        self._session_id = getattr(self._session, "id", None)
-        self._running = True
+            # Create and start the CopilotClient (spawns copilot CLI process)
+            subprocess_config = SubprocessConfig(cwd=self.directory, env=isolated_env)
+            self._client = CopilotClient(config=subprocess_config)
+            await self._client.start()
+
+            # Create a session with model and permissions.
+            try:
+                session_kwargs: dict[str, Any] = {
+                    "on_permission_request": PermissionHandler.approve_all,
+                    "model": self.model,
+                }
+                if self.system_prompt:
+                    session_kwargs["system_message"] = {"content": self.system_prompt}
+                if self.skill_directories:
+                    session_kwargs["skill_directories"] = self.skill_directories
+
+                self._session = await self._client.create_session(**session_kwargs)
+            except Exception:
+                await self._client.stop()
+                self._client = None
+                raise
+            self._session_id = getattr(self._session, "id", None)
+            self._running = True
 
-        logger.info(
-            "CopilotAgentRunner started (model=%s, session=%s)",
-            self.model, self._session_id,
-        )
+            logger.info(
+                "CopilotAgentRunner started (model=%s, session=%s)",
+                self.model, self._session_id,
+            )
 
-        # Start the prompt processing loop
-        self._task = asyncio.create_task(self._prompt_loop())
+            # Start the prompt processing loop
+            self._task = asyncio.create_task(self._prompt_loop())
 
-        if initial_prompt:
-            await self.send_prompt(initial_prompt)
+            if initial_prompt:
+                await self.send_prompt(initial_prompt)
+        except Exception:
+            shutil.rmtree(self._isolated_home, ignore_errors=True)
+            self._isolated_home = None
+            raise
 
     async def stop(self) -> None:
         """Stop the Copilot session and client."""
@@ -113,6 +126,10 @@ class CopilotAgentRunner:
                 logger.debug("Client stop error (ignoring)", exc_info=True)
             self._client = None
 
+        if self._isolated_home:
+            shutil.rmtree(self._isolated_home, ignore_errors=True)
+            self._isolated_home = None
+
     async def send_prompt(self, text: str) -> None:
         """Queue a prompt for the agent."""
         await self._prompt_queue.put(text)

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/copilot/daemon.py

@@ -334,9 +334,6 @@ class CopilotDaemon:
             elif msg_type == "irc_ask":
                 return await self._ipc_irc_ask(req_id, msg)
 
-            elif msg_type == "set_directory":
-                return await self._ipc_set_directory(req_id, msg)
-
             elif msg_type == "compact":
                 return await self._ipc_compact(req_id)
 
@@ -430,26 +427,6 @@ class CopilotDaemon:
         # Response matching is TODO
         return make_response(req_id, ok=True)
 
-    async def _ipc_set_directory(self, req_id: str, msg: dict) -> dict:
-        path = msg.get("path", "")
-        if not path:
-            return make_response(req_id, ok=False, error="Missing 'path'")
-        new_cwd = os.path.abspath(path)
-        if not os.path.isdir(new_cwd):
-            return make_response(req_id, ok=False, error=f"Not a directory: {new_cwd}")
-        # Update the daemon's working directory
-        self.agent.directory = new_cwd
-        # Check for .github/copilot-instructions.md (Copilot's project instructions)
-        copilot_instructions = os.path.join(new_cwd, ".github", "copilot-instructions.md")
-        instructions_content = None
-        if os.path.isfile(copilot_instructions):
-            with open(copilot_instructions) as f:
-                instructions_content = f.read()
-        return make_response(req_id, ok=True, data={
-            "directory": new_cwd,
-            "copilot_instructions": instructions_content,
-        })
-
     async def _ipc_compact(self, req_id: str) -> dict:
         if self._agent_runner is None or not self._agent_runner.is_running():
             return make_response(req_id, ok=False, error="Agent runner is not running")

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/copilot/skill/irc_client.py

@@ -173,10 +173,6 @@ class SkillClient:
         """Send /clear to the Copilot agent runner."""
         return await self._request("clear")
 
-    async def set_directory(self, directory: str) -> dict[str, Any]:
-        """Change the working directory for the agent runner."""
-        return await self._request("set_directory", path=directory)
-
 
 # ---------------------------------------------------------------------------
 # CLI
@@ -197,7 +193,7 @@ async def _main(args: list[str]) -> None:
     if not args:
         print(
             "Usage: irc_client.py <subcommand> [args...]\n"
-            "Subcommands: send, read, ask, join, part, channels, who, compact, clear, set-directory",
+            "Subcommands: send, read, ask, join, part, channels, who, compact, clear",
             file=sys.stderr,
         )
         sys.exit(1)
@@ -255,10 +251,6 @@ async def _main(args: list[str]) -> None:
         elif subcommand == "clear":
             result = await client.clear()
 
-        elif subcommand == "set-directory":
-            directory = args[1]
-            result = await client.set_directory(directory)
-
         else:
             print(f"ERROR: Unknown subcommand: {subcommand!r}", file=sys.stderr)
             sys.exit(1)

{agentirc_cli-0.9.0 → agentirc_cli-0.10.1}/agentirc/clients/copilot/supervisor.py

@@ -4,6 +4,9 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
+import shutil
+import tempfile
 from dataclasses import dataclass
 from typing import Any, Awaitable, Callable
 
@@ -85,11 +88,16 @@ class CopilotSupervisor:
         transcript = self._format_transcript()
         prompt = SUPERVISOR_PROMPT.format(transcript=transcript)
 
+        # Isolate from host config
+        isolated_home = tempfile.mkdtemp(prefix="agentirc-copilot-sv-")
+
         try:
-            from copilot import CopilotClient
+            from copilot import CopilotClient, SubprocessConfig
             from copilot.session import PermissionHandler
 
-            client = CopilotClient()
+            isolated_env = {**os.environ, "HOME": isolated_home}
+            subprocess_config = SubprocessConfig(env=isolated_env)
+            client = CopilotClient(config=subprocess_config)
             await client.start()
             try:
                 session = await client.create_session(
@@ -117,6 +125,8 @@ class CopilotSupervisor:
         except Exception:
             logger.exception("Copilot supervisor evaluation failed")
             return
+        finally:
+            shutil.rmtree(isolated_home, ignore_errors=True)
 
         if verdict.action == "ESCALATION":
             self._escalation_count += 1