agentainer 0.1.1 → 0.1.2

package/README.md

@@ -135,15 +135,15 @@ Getting that to work reliably against a live TUI took more than a sleep:
 - **Claude Code silently discards keystrokes for several seconds partway through
   startup.** Measured on v2.1.205: input at t=2s landed, t=6s and t=12s vanished,
   t=20s landed. A fixed `boot_delay_ms` is therefore a coin flip. Before typing,
-  AgentSwarm types a throwaway token and waits for the input box to echo it back,
+  Agentainer types a throwaway token and waits for the input box to echo it back,
   then erases it (`ready_probe`). Enter is never sent, so nothing is submitted.
-- **Readiness is not monotonic**, so after pasting, AgentSwarm checks that the
+- **Readiness is not monotonic**, so after pasting, Agentainer checks that the
   text actually appeared on screen before pressing Enter, and retries if it did
   not. If delivery cannot be confirmed it refuses to press Enter, rather than
   submitting a half-delivered prompt.
 - **Both CLIs open a "do you trust this folder?" modal** on first run in a new
   directory, which would eat the first prompt (Enter answers the dialog). Claude
-  does this even under `--dangerously-skip-permissions`. AgentSwarm pre-trusts each
+  does this even under `--dangerously-skip-permissions`. Agentainer pre-trusts each
   agent's workdir: for codex in its generated `config.toml`, for claude by adding
   `hasTrustDialogAccepted` for that path in `~/.claude.json`.
 - **Both collapse a long paste into a chip** rather than showing the text —
@@ -199,7 +199,7 @@ tmux send-keys -t reviewer -l "your message" && tmux send-keys -t reviewer Enter
 **Agents get reminded when their answer goes nowhere.** A model that was asked a
 question will often just *write the answer as prose* and end its turn — and that
 prose reaches nobody, because only a `<swarm-send>` block is delivered. So when an
-agent owes a reply and finishes a turn without sending one, AgentSwarm messages it:
+agent owes a reply and finishes a turn without sending one, Agentainer messages it:
 
 ```
 Your last turn sent no message to anyone, and lead is waiting on your answer to
@@ -214,7 +214,7 @@ If instead the agent *tried* to send but the block was malformed, it gets the
 specific diagnosis — unclosed tag, missing `to`, unknown recipient, permission
 denied — so it can correct itself rather than lose the message silently.
 
-It is reminded at most `max_reply_reminders` times (default **1**), then AgentSwarm
+It is reminded at most `max_reply_reminders` times (default **1**), then Agentainer
 gives up and stops nagging. An agent that auto-forwards via `forward_responses_to`
 is never reminded, since its words did reach someone. Turn it off per agent with
 `reply_reminder: false`.
@@ -262,7 +262,7 @@ agent sees on its own terminal. Use `can_talk_to: "*"` for "everyone else".
 
 ## Capturing what an agent says
 
-AgentSwarm needs to know when an agent finishes a turn — both to log it and to
+Agentainer needs to know when an agent finishes a turn — both to log it and to
 support auto-forwarding. How it finds out depends on the CLI, and the two
 mechanisms are **not** equally good:
 
@@ -276,7 +276,7 @@ mechanisms are **not** equally good:
   with **no `matcher` key** (`Stop` is not a tool event, and supplying one stops the
   interactive TUI from ever running the hook). It reads the session transcript.
   Claude fires the hook *before* flushing the assistant message to that transcript,
-  so AgentSwarm polls it briefly, and only reads text written after the last user
+  so Agentainer polls it briefly, and only reads text written after the last user
   message — otherwise a turn would silently capture nothing, or re-relay the
   previous turn's reply.
 - **codex** → the agent gets a private `CODEX_HOME` at `<agent-dir>/.codex/`
@@ -379,7 +379,7 @@ Some honest limits:
   busy forever. After `busy_timeout_ms` (default 15 minutes) it is treated as idle
   again, with a warning. `swarm idle <agent>` clears it immediately. Any mail queued
   for such an agent is not lost either: whenever some *other* agent finishes a turn,
-  AgentSwarm sweeps the now-idle agent's queue and delivers what was stranded — so
+  Agentainer sweeps the now-idle agent's queue and delivers what was stranded — so
   one missed turn-completion cannot wedge a queue permanently.
 - A capture only fires if the agent's `type` matches the CLI its `command` actually
   runs. If you point a `type: codex` agent at a `claude` command (e.g. through an
@@ -478,7 +478,7 @@ agent_types:
 
 `defaults:` supplies any agent key for agents that don't set it, including
 `workdir` — useful for putting a whole swarm in one repository. `templates:`
-overrides the text AgentSwarm generates — `comms` and `task_notice` (appended to
+overrides the text Agentainer generates — `comms` and `task_notice` (appended to
 first prompts), plus `reply_reminder` and `send_failed` (the nudges) —
 with `{agent} {swarm} {peers} {prefix} {inbox} {workdir}` available as
 placeholders.
@@ -568,7 +568,7 @@ being skipped, and a transcript read before Claude has flushed it.
 ## Troubleshooting
 
 **"could not confirm the text arrived; NOT pressing Enter".** The agent's input
-box never echoed the prompt, so AgentSwarm refused to submit it. Attach to the
+box never echoed the prompt, so Agentainer refused to submit it. Attach to the
 session to see what state the CLI is in -- usually a modal (login, trust,
 onboarding) is holding focus. Raise `ready_timeout_ms` if the CLI is merely slow.
 
@@ -587,7 +587,7 @@ exists and `.swarm/logs/hooks.log` for errors. If the agent also looks busy fore
 its `type` probably does not match the CLI its `command` runs (see the capture note
 under [Busy agents](#busy-agents-and-backpressure)).
 
-**Can't scroll up in an attached session.** AgentSwarm raises tmux's scrollback to
+**Can't scroll up in an attached session.** Agentainer raises tmux's scrollback to
 `tmux_history_limit` (50000 lines) and turns on `tmux_mouse`, so the wheel scrolls
 the backlog; press `q` to leave copy mode. If your terminal grabs the wheel itself,
 use `Ctrl-b [` then PageUp. Both options are set on the tmux server before sessions

package/agents.example.yaml

@@ -1,5 +1,5 @@
 # =============================================================================
-# AgentSwarm example configuration
+# Agentainer example configuration
 #
 #   cp agents.example.yaml agents.yaml
 #   agentainer validate --show-prompts     # check it without launching anything
@@ -32,7 +32,7 @@ swarm:
   # (optional) How long to keep probing an agent's input box for a response
   # before giving up and typing the first prompt anyway. Some CLIs (Claude Code)
   # silently discard keystrokes for several seconds partway through startup, so
-  # AgentSwarm waits for the input box to echo a throwaway token before typing.
+  # Agentainer waits for the input box to echo a throwaway token before typing.
   ready_timeout_ms: 60000
 
   # (optional) An agent is "busy" from when a message is submitted to it until its
@@ -50,7 +50,7 @@ swarm:
 
   # (optional) An agent that answers a question as plain prose sends nothing: only a
   # <swarm-send> block is delivered. When it owes a reply and its turn ends without
-  # one, AgentSwarm messages it explaining how to send. This is how many times.
+  # one, Agentainer messages it explaining how to send. This is how many times.
   max_reply_reminders: 1
 
   # (optional) Reattach agents to their previous conversations on `up`, using the ids
@@ -63,9 +63,9 @@ swarm:
   pane_poll_ms: 700       # how often the watcher samples the pane
   pane_scrollback: 400    # lines of scrollback to diff
 
-  # (optional) tmux comfort settings for when you `swarm attach <agent>`.
+  # (optional) tmux comfort settings for when you `agentainer attach <agent>`.
   # The default tmux scrollback (2000 lines) is too small to hold a long
-  # multi-agent conversation, so AgentSwarm raises it before creating sessions.
+  # multi-agent conversation, so Agentainer raises it before creating sessions.
   # mouse mode lets you wheel-scroll the backlog; press q to leave copy mode.
   # Both are applied to the tmux server, so they also affect your other sessions.
   tmux_history_limit: 50000   # lines of scrollback per agent pane (0 = leave tmux's default)
@@ -85,13 +85,13 @@ defaults:
 # agent_types (optional) -- override the built-in launch commands, or define
 # entirely new agent types. Built-ins are: claude, codex, gemini, hermes.
 #
-#   capture: how AgentSwarm learns that an agent finished a turn.
+#   capture: how Agentainer learns that an agent finished a turn.
 #     hook -- the CLI can run an external program on turn completion.
 #             Supported for claude (Stop hook) and codex (notify program).
 #     pane -- no such facility: poll the tmux pane and diff it. Heuristic.
 #     none -- do not capture at all.
 #
-#   boot_delay_ms: a grace period before AgentSwarm starts probing the input
+#   boot_delay_ms: a grace period before Agentainer starts probing the input
 #     box. It does NOT need to cover the full startup time -- delivery of the
 #     first prompt is verified and retried, so a small value is fine.
 # -----------------------------------------------------------------------------
@@ -214,7 +214,7 @@ agents:
     # single `defaults.workdir` can serve every agent, e.g. "{root}/{name}-wt".
     #
     # Several agents may share one directory (they then see each other's edits;
-    # AgentSwarm warns you). Pair `create_workdir: false` with an existing
+    # Agentainer warns you). Pair `create_workdir: false` with an existing
     # project so a bad path is an error, not a new empty folder.
     #
     # workdir: ~/projects/acme-api
@@ -245,7 +245,7 @@ agents:
       You are the SCRIBE. Keep a running changelog of the project in NOTES.md.
 
 # -----------------------------------------------------------------------------
-# templates (optional) -- override the text AgentSwarm appends to first prompts.
+# templates (optional) -- override the text Agentainer appends to first prompts.
 # Available placeholders: {agent} {swarm} {peers} {prefix} {inbox} {workdir}
 # -----------------------------------------------------------------------------
 #

package/lib/config.py

@@ -1,4 +1,4 @@
-"""Load, normalise and validate an AgentSwarm YAML config."""
+"""Load, normalise and validate an Agentainer YAML config."""
 
 from __future__ import annotations
 
@@ -70,9 +70,9 @@ NAME_RE = re.compile(r"^[A-Za-z0-9_][A-Za-z0-9_-]*$")
 
 DEFAULT_COMMS_TEMPLATE = """\
 ---
-## Swarm communication protocol
+## Inter-agent communication protocol
 
-You are the agent **{agent}** in the "{swarm}" swarm.
+You are the agent **{agent}** on the **{swarm}** team.
 Agents you are allowed to message: {peers}
 
 ### Receiving
@@ -108,7 +108,7 @@ literally, across as many lines as you need:
 To reach everyone you are allowed to talk to, use `<swarm-broadcast>` with no `to`.
 
 The `reply-to` attribute is optional; drop it when you are starting a new thread.
-Quoting it also tells the swarm your message is an answer, so the other agent is not
+Quoting it also marks your message as an answer, so the other agent is not
 chased for a reply to it. For an announcement that needs no answer, either use
 `<swarm-broadcast>` or add `expects-reply="false"`.
 
@@ -577,7 +577,7 @@ def load(path: str | os.PathLike) -> SwarmConfig:
         if not agent.workdir.exists() and not agent.create_workdir:
             raise ConfigError(
                 f"agent {agent.name!r}: workdir does not exist: {agent.workdir}\n"
-                "   Create it yourself, or allow AgentSwarm to: create_workdir: true"
+                "   Create it yourself, or allow Agentainer to: create_workdir: true"
             )
 
     shared: dict[Path, list[str]] = {}

package/lib/minyaml.py

@@ -1,7 +1,7 @@
 """A small YAML-subset parser.
 
-Used only when PyYAML is not importable, so that AgentSwarm keeps working on a
-bare Python 3 install. Supports the subset AgentSwarm configs actually need:
+Used only when PyYAML is not importable, so that Agentainer keeps working on a
+bare Python 3 install. Supports the subset Agentainer configs actually need:
 
   * nested block mappings and block sequences
   * scalars: strings, ints, floats, booleans, null

package/lib/swarm.py

@@ -551,8 +551,8 @@ def read_sessions(cfg: SwarmConfig) -> dict:
 def write_sessions(cfg: SwarmConfig, agents: dict) -> None:
     cfg.runtime.mkdir(parents=True, exist_ok=True)
     header = (
-        "# AgentSwarm session state -- written automatically as agents work.\n"
-        "# `swarm up --resume` reads this to reattach each agent to its own\n"
+        "# Agentainer session state -- written automatically as agents work.\n"
+        "# `agentainer up --resume` reads this to reattach each agent to its own\n"
         "# conversation after a restart. Safe to delete; you then start fresh.\n"
     )
     body = yaml_dump(
@@ -848,7 +848,7 @@ def deliver(
     if not session_exists(target.session):
         raise SwarmError(
             f"agent {recipient!r} is not running (tmux session {target.session!r} missing). "
-            "Start it with: swarm up"
+            "Start it with: agentainer up"
         )
 
     msg_id = new_message_id()
@@ -873,7 +873,7 @@ def deliver(
         if not _paste_locked(cfg, target.session, body, enter=True, needle=needle):
             raise SwarmError(
                 f"could not confirm the message reached {recipient!r}; "
-                f"inspect it with: swarm attach {recipient}"
+                f"inspect it with: agentainer attach {recipient}"
             )
 
         with file_lock(cfg, recipient, "turn.lock"):
@@ -1232,7 +1232,7 @@ def install_codex_hook(agent: Agent) -> Path:
     # to that table. `notify` must therefore come before anything else, or codex
     # reads it as projects.<dir>.notify and never calls it.
     chunks = [
-        "# installed by AgentSwarm -- fires when codex finishes a turn.",
+        "# installed by Agentainer -- fires when codex finishes a turn.",
         "# Keep `notify` above every [table] header: TOML is order-sensitive.",
         f"notify = [{notify}]",
         "",
@@ -2043,7 +2043,7 @@ def cmd_inbox(args) -> int:
     cfg = cfgmod.load(args.config)
     name = args.agent or os.environ.get("SWARM_AGENT")
     if not name:
-        die("specify an agent: swarm inbox <agent>")
+        die("specify an agent: agentainer inbox <agent>")
     cfg.get(name)
 
     box = cfg.inbox_dir / name

package/llms.txt

@@ -1,11 +1,11 @@
-# AgentSwarm
+# Agentainer
 
-> AgentSwarm runs several coding-agent CLIs (Claude Code, Codex, Gemini, Hermes) at once.
+> Agentainer runs several coding-agent CLIs (Claude Code, Codex, Gemini, Hermes) at once.
 > Each agent gets its own directory and its own tmux session. A single YAML file defines
 > the agents, the command that launches each one, its first prompt, and — as a strict
 > whitelist — which other agents it is allowed to message.
 >
-> This file is the reference for LLMs asked to write or repair an AgentSwarm config.
+> This file is the reference for LLMs asked to write or repair an Agentainer config.
 > If you are configuring a swarm, everything you need is below. Verify your work with
 > `agentainer validate --show-prompts`, which parses the config and launches nothing.
 
@@ -82,7 +82,7 @@ agents:
     append_agents_that_you_can_talk_to_prompt: true
     in_first_prompt_append_your_task_will_be_sent_in_the_next_prompt: false
 
-templates:                 # override the text AgentSwarm generates
+templates:                 # override the text Agentainer generates
   comms: |                 # placeholders: {agent} {swarm} {peers} {prefix} {inbox} {workdir}
     You are {agent}. You may message: {peers}.
   task_notice: |
@@ -169,7 +169,7 @@ prose reaches nobody -- only a `<swarm-send>` block is delivered. So:
   to write.
 - If B *tried* to send but the block was malformed -- unclosed, missing `to`, unknown
   recipient, permission denied -- it gets the `send_failed` template naming each fault.
-- At most `max_reply_reminders` nudges (default 1), then AgentSwarm gives up silently.
+- At most `max_reply_reminders` nudges (default 1), then Agentainer gives up silently.
 - Anything B delivered counts, including an auto-forward via `forward_responses_to`.
   Reminders are sent from `swarm`, so they never create a reply obligation themselves.
 - `reply_reminder: false` disables it per agent; it is forced off when the agent's
@@ -387,7 +387,7 @@ agents:
   limit stops them. Prefer one-directional forwarding, or none.
 - `--dangerously-skip-permissions` / `--yolo` let agents run tools unsupervised. Point
   `root` at a disposable directory.
-- The first prompt is typed into a live TUI. If AgentSwarm reports "could not confirm
+- The first prompt is typed into a live TUI. If Agentainer reports "could not confirm
   the text arrived", the CLI is usually stuck behind a modal (login, trust, onboarding);
   attach to the session and look. Raise `ready_timeout_ms` if it is merely slow.
 - PyYAML is used when installed; otherwise a bundled subset parser handles the config.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentainer",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Run a configurable swarm of coding-agent CLIs (Claude Code, Codex, Gemini) in tmux and let them talk to each other.",
   "keywords": [
     "agents",