agentainer 0.1.0 → 0.1.1

package/README.md

@@ -4,8 +4,8 @@ Run a team of coding agents — **Claude Code, Codex, Gemini CLI, Hermes** — s
 side in tmux, each in its own directory, each able to message the others only if
 your YAML file says it may.
 
-> Formerly **AgentSwarm**. Installed globally, the command is `agentainer`; the
-> repo's `./swarm.sh` remains a drop-in equivalent for local development.
+> Formerly **AgentSwarm**. Installed globally the command is `agentainer`; from a
+> clone, the `./agentainer` script in the repo root is the same thing.
 
 ```
    agents.yaml                 tmux
@@ -31,7 +31,7 @@ the agent's CLI, and types each agent's first prompt into it.
 
 - `tmux` (3.0+)
 - `python3` — PyYAML is used if present, otherwise a bundled parser handles the config
-- `node` (16+) — only for the global `agentainer` command; not needed if you run `./swarm.sh` from a clone
+- `node` (16+) — only for the global `agentainer` command; not needed if you run `./agentainer` from a clone
 - whichever agent CLIs you reference: `claude`, `codex`, `gemini`, `hermes` — install only the one(s) you actually use
 
 ## Install
@@ -51,7 +51,7 @@ Or from a clone (no npm needed):
 
 ```bash
 git clone https://github.com/mehmetcanfarsak/AgentSwarm.git && cd AgentSwarm
-./swarm.sh --help        # same commands as `agentainer`, straight from the repo
+./agentainer --help      # same commands as the global `agentainer`, straight from the repo
 ```
 
 ## Quickstart
@@ -69,15 +69,15 @@ agentainer down          # stop everything
 Give the swarm its actual work:
 
 ```bash
-./swarm.sh send --to orchestrator "Build a CLI that converts CSV to Parquet."
+agentainer send --to orchestrator "Build a CLI that converts CSV to Parquet."
 ```
 
 Watch the traffic between agents:
 
 ```bash
-./swarm.sh logs -f              # whole swarm, live
-./swarm.sh logs reviewer -n 20  # one agent
-./swarm.sh inbox developer      # messages an agent received
+agentainer logs -f              # whole swarm, live
+agentainer logs reviewer -n 20  # one agent
+agentainer inbox developer      # messages an agent received
 ```
 
 ---
@@ -236,8 +236,8 @@ conversation instead of starting a fresh one — it does not re-send the first
 prompt, and it keeps any mail still queued for that agent:
 
 ```bash
-./swarm.sh sessions          # what is recorded, and the command that would resume it
-./swarm.sh up --resume       # reattach; agents without a recorded id start fresh
+agentainer sessions          # what is recorded, and the command that would resume it
+agentainer up --resume       # reattach; agents without a recorded id start fresh
 ```
 
 Claude is resumed with `--resume <id>`, codex with `resume <id>`. Set
@@ -497,9 +497,9 @@ Ready-to-run swarms in [`examples/`](examples/):
 | [`existing-repo.yaml`](examples/existing-repo.yaml) | Pairing | Two agents in one **existing** checkout, with `create_workdirs: false` |
 
 ```bash
-./swarm.sh validate -c examples/research-swarm.yaml   # look before you leap
-./swarm.sh up       -c examples/research-swarm.yaml
-./swarm.sh send --to lead "Research the state of WebGPU compute shaders."
+agentainer validate -c examples/research-swarm.yaml   # look before you leap
+agentainer up       -c examples/research-swarm.yaml
+agentainer send --to lead "Research the state of WebGPU compute shaders."
 ```
 
 `existing-repo.yaml` intentionally refuses to start until you point `workdir` at
@@ -509,28 +509,28 @@ a repository that exists.
 
 | Command | Purpose |
 |---|---|
-| `swarm.sh up` | Start the swarm. `--only a,b`, `--restart`, `--resume`, `--no-prompt`, `--attach` |
-| `swarm.sh down` | Kill sessions and watchers. `--only a,b` |
-| `swarm.sh restart` | `down` then `up` |
-| `swarm.sh status` | Table of agents, sessions, capture mode, permissions |
-| `swarm.sh attach <agent>` | Attach to an agent's tmux session |
-| `swarm.sh send --to <agent> "msg"` | Deliver a message (`--from`, `--file`, `--queue`, `--wait`, `--ignore-busy`, `--force`) |
-| `swarm.sh broadcast "msg"` | Message everyone the sender may talk to |
-| `swarm.sh sessions` | Show each agent's recorded conversation id (`--raw`) |
-| `swarm.sh queue <agent>` | Show what is waiting for a busy agent (`--clear`) |
-| `swarm.sh idle <agent>` | Force an agent back to idle, then drain its queue |
-| `swarm.sh inbox <agent>` | Print archived messages |
-| `swarm.sh logs [agent] [-f]` | Event log: prompts, responses, messages |
-| `swarm.sh validate` | Parse the config. `--show-prompts` renders final prompts |
-
-`./swarm.sh my-swarm.yaml` is shorthand for `./swarm.sh up -c my-swarm.yaml`.
+| `agentainer up` | Start the swarm. `--only a,b`, `--restart`, `--resume`, `--no-prompt`, `--attach` |
+| `agentainer down` | Kill sessions and watchers. `--only a,b` |
+| `agentainer restart` | `down` then `up` |
+| `agentainer status` | Table of agents, sessions, capture mode, permissions |
+| `agentainer attach <agent>` | Attach to an agent's tmux session |
+| `agentainer send --to <agent> "msg"` | Deliver a message (`--from`, `--file`, `--queue`, `--wait`, `--ignore-busy`, `--force`) |
+| `agentainer broadcast "msg"` | Message everyone the sender may talk to |
+| `agentainer sessions` | Show each agent's recorded conversation id (`--raw`) |
+| `agentainer queue <agent>` | Show what is waiting for a busy agent (`--clear`) |
+| `agentainer idle <agent>` | Force an agent back to idle, then drain its queue |
+| `agentainer inbox <agent>` | Print archived messages |
+| `agentainer logs [agent] [-f]` | Event log: prompts, responses, messages |
+| `agentainer validate` | Parse the config. `--show-prompts` renders final prompts |
+
+`agentainer my-swarm.yaml` is shorthand for `agentainer up -c my-swarm.yaml`.
 `-c` and `$SWARM_CONFIG` both select a config; `-c` wins.
 
 ## Layout
 
 ```
 AgentSwarm/
-├── swarm.sh                # entrypoint
+├── agentainer                # entrypoint
 ├── agents.example.yaml     # annotated config
 ├── llms.txt                # reference for agents configuring this tool
 ├── hooks/

package/{swarm.sh → agentainer}

@@ -1,14 +1,14 @@
 #!/usr/bin/env bash
 #
-# AgentSwarm -- launch a configurable swarm of coding agents in tmux.
+# Agentainer -- launch a configurable swarm of coding agents in tmux.
 #
-#   ./swarm.sh up                    start every agent in agents.yaml
-#   ./swarm.sh up -c my-swarm.yaml   ...from a different config
-#   ./swarm.sh agents.yaml           shorthand for `up -c agents.yaml`
-#   ./swarm.sh status                see who is running
-#   ./swarm.sh send --to dev "hi"    message an agent
-#   ./swarm.sh attach dev            jump into an agent's tmux session
-#   ./swarm.sh down                  stop everything
+#   ./agentainer up                    start every agent in agents.yaml
+#   ./agentainer up -c my-swarm.yaml   ...from a different config
+#   ./agentainer agents.yaml           shorthand for `up -c agents.yaml`
+#   ./agentainer status                see who is running
+#   ./agentainer send --to dev "hi"    message an agent
+#   ./agentainer attach dev            jump into an agent's tmux session
+#   ./agentainer down                  stop everything
 #
 # See README.md for the full reference, or llms.txt if you are an LLM.
 set -euo pipefail
@@ -27,7 +27,7 @@ if [[ -z "$PYTHON" ]]; then
 fi
 
 if [[ -z "$PYTHON" ]]; then
-  echo "xx AgentSwarm needs python3 on PATH (or set SWARM_PYTHON)" >&2
+  echo "xx Agentainer needs python3 on PATH (or set SWARM_PYTHON)" >&2
   exit 1
 fi
 

package/agents.example.yaml

@@ -2,8 +2,8 @@
 # AgentSwarm example configuration
 #
 #   cp agents.example.yaml agents.yaml
-#   ./swarm.sh validate --show-prompts     # check it without launching anything
-#   ./swarm.sh up                          # launch the swarm
+#   agentainer validate --show-prompts     # check it without launching anything
+#   agentainer up                          # launch the swarm
 #
 # Every key is documented inline. Anything marked (optional) can be omitted.
 # =============================================================================

package/bin/agentainer.js

@@ -21,7 +21,7 @@ if (process.argv[2] === "doctor") {
   process.exit(r.status === null ? 1 : r.status);
 }
 
-// Locate a Python interpreter, mirroring swarm.sh (SWARM_PYTHON, then python3,
+// Locate a Python interpreter, mirroring ./agentainer (SWARM_PYTHON, then python3,
 // then python).
 function findPython() {
   const candidates = process.env.SWARM_PYTHON

package/examples/bug-hunt.yaml

@@ -1,8 +1,8 @@
 # =============================================================================
 # Bug hunt -- an automatic pipeline: reproduce -> diagnose -> fix -> verify.
 #
-#   ./swarm.sh up -c examples/bug-hunt.yaml
-#   ./swarm.sh send --to reproducer "Uploads over 2MB fail with a 500 in prod."
+#   agentainer up -c examples/bug-hunt.yaml
+#   agentainer send --to reproducer "Uploads over 2MB fail with a 500 in prod."
 #
 # This is the one shape where `forward_responses_to` earns its keep: each stage
 # hands its finished turn to the next stage automatically, with no human in the

package/examples/existing-repo.yaml

@@ -6,9 +6,9 @@
 # writes the code and a navigator who reads it as it lands.
 #
 #   1. Point `workdir` below at a real repository.
-#   2. ./swarm.sh validate -c examples/existing-repo.yaml
-#   3. ./swarm.sh up       -c examples/existing-repo.yaml
-#   4. ./swarm.sh send --to driver "Add retry-with-backoff to the HTTP client."
+#   2. agentainer validate -c examples/existing-repo.yaml
+#   3. agentainer up       -c examples/existing-repo.yaml
+#   4. agentainer send --to driver "Add retry-with-backoff to the HTTP client."
 #
 # Until you edit the paths, `validate` will refuse to run and tell you so --
 # that is the point of `create_workdir: false`.

package/examples/research-swarm.yaml

@@ -1,8 +1,8 @@
 # =============================================================================
 # Research swarm -- a small team that investigates a topic and writes it up.
 #
-#   ./swarm.sh up -c examples/research-swarm.yaml
-#   ./swarm.sh send --to lead "Research the state of WebGPU compute shaders."
+#   agentainer up -c examples/research-swarm.yaml
+#   agentainer send --to lead "Research the state of WebGPU compute shaders."
 #
 # Shape: hub and spoke. The lead hands out work and assembles the result; the
 # specialists only ever report back to the lead (and to each other where it
@@ -21,7 +21,7 @@ agents:
 
   - name: lead
     type: claude
-    command: "bash -ic 'chy3'"
+    command: "claude --dangerously-skip-permissions"
     can_talk_to: ["scout", "analyst", "writer"]
 
     # The lead waits for the human to supply the research question.
@@ -51,8 +51,8 @@ agents:
       Never accept "it depends" as a final answer. Force a recommendation.
 
   - name: scout
-    type: claude
-    command: "bash -ic 'chy3'"
+    type: gemini
+    command: "gemini --yolo"
     can_talk_to: ["lead", "analyst"]
 
     # Gemini has no turn-completion hook, so its output would have to be scraped
@@ -79,8 +79,8 @@ agents:
       of guessing. Say plainly when you could not find something.
 
   - name: analyst
-    type: claude
-    command: "bash -ic 'chy3'"
+    type: codex
+    command: "codex --yolo"
     can_talk_to: ["lead", "scout"]
 
     first_prompt: |
@@ -101,7 +101,7 @@ agents:
 
   - name: writer
     type: claude
-    command: "bash -ic 'chy3'"
+    command: "claude --dangerously-skip-permissions"
     can_talk_to: ["lead"]
 
     # A custom folder: the report lands somewhere predictable, outside the

package/examples/software-company.yaml

@@ -2,8 +2,8 @@
 # Software company -- a product team with a CTO, an architect, two developers,
 # a QA reviewer and a technical writer.
 #
-#   ./swarm.sh up -c examples/software-company.yaml
-#   ./swarm.sh send --to cto "Build a URL shortener with an API and a web UI."
+#   agentainer up -c examples/software-company.yaml
+#   agentainer send --to cto "Build a URL shortener with an API and a web UI."
 #
 # The communication graph is deliberately not a free-for-all: developers talk to
 # their architect and to QA, but not to each other, so design decisions go

package/hooks/claude_stop.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # Claude Code `Stop` hook: fires when Claude finishes responding.
 # Claude passes a JSON payload on stdin containing `transcript_path`.
-# Installed automatically into <agent-workdir>/.claude/settings.json by `swarm up`.
+# Installed automatically into <agent-workdir>/.claude/settings.json by `agentainer up`.
 #
 # A hook must never break the agent it is attached to, so every failure here is
 # swallowed and the script always exits 0.
@@ -13,5 +13,5 @@ if [[ -n "${SWARM_ROOT:-}" ]] && mkdir -p "$SWARM_ROOT/.swarm/logs" 2>/dev/null;
   log="$SWARM_ROOT/.swarm/logs/hooks.log"
 fi
 
-"$HERE/swarm.sh" hook claude >>"$log" 2>&1
+"$HERE/agentainer" hook claude >>"$log" 2>&1
 exit 0

package/hooks/codex_notify.sh

@@ -12,5 +12,5 @@ if [[ -n "${SWARM_ROOT:-}" ]] && mkdir -p "$SWARM_ROOT/.swarm/logs" 2>/dev/null;
   log="$SWARM_ROOT/.swarm/logs/hooks.log"
 fi
 
-"$HERE/swarm.sh" hook codex "${1:-}" >>"$log" 2>&1
+"$HERE/agentainer" hook codex "${1:-}" >>"$log" 2>&1
 exit 0

package/lib/config.py

@@ -312,7 +312,7 @@ def load(path: str | os.PathLike) -> SwarmConfig:
         raise ConfigError(
             f"config file not found: {cfg_path}\n"
             "   Create one with:  cp agents.example.yaml agents.yaml\n"
-            "   Or point at it:   swarm.sh -c /path/to/swarm.yaml up"
+            "   Or point at it:   agentainer -c /path/to/swarm.yaml up"
         )
 
     try:

package/lib/swarm.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
-"""AgentSwarm -- run a swarm of coding agents in tmux and let them talk.
+"""Agentainer -- run a swarm of coding agents in tmux and let them talk.
 
-Invoked through ``swarm.sh``; see ``swarm.sh --help`` and README.md.
+Invoked through ``agentainer`` (or ``./agentainer`` from a clone); see
+``agentainer --help`` and README.md.
 """
 
 from __future__ import annotations
@@ -1609,8 +1610,8 @@ def write_shim(cfg: SwarmConfig) -> None:
     shim = cfg.bin_dir / "swarm"
     shim.write_text(
         "#!/usr/bin/env bash\n"
-        "# Generated by AgentSwarm. Lets an agent run `swarm send ...` from its shell.\n"
-        f'exec {shlex.quote(str(SWARM_HOME / "swarm.sh"))} "$@"\n'
+        "# Generated by Agentainer. Lets an agent run `swarm send ...` from its shell.\n"
+        f'exec {shlex.quote(str(SWARM_HOME / "agentainer"))} "$@"\n'
     )
     shim.chmod(0o755)
 
@@ -1803,7 +1804,7 @@ def cmd_up(args) -> int:
     print()
     info(f"swarm {cfg.name!r} is up with {len(started)} agent(s)")
     info(f"attach with:  tmux attach -t {started[0].session}")
-    info(f"or:           {SWARM_HOME / 'swarm.sh'} attach {started[0].name}")
+    info(f"or:           {SWARM_HOME / 'agentainer'} attach {started[0].name}")
 
     if args.attach:
         os.execvp("tmux", ["tmux", "attach", "-t", started[0].session])
@@ -2129,7 +2130,7 @@ def select_agents(cfg: SwarmConfig, only: str | None) -> list[Agent]:
 
 
 def default_config() -> str:
-    """SWARM_CONFIG, else ./agents.yaml, else the agents.yaml beside swarm.sh."""
+    """SWARM_CONFIG, else ./agents.yaml, else the agents.yaml beside agentainer."""
     from_env = os.environ.get("SWARM_CONFIG")
     if from_env:
         return from_env

package/llms.txt

@@ -7,11 +7,11 @@
 >
 > This file is the reference for LLMs asked to write or repair an AgentSwarm config.
 > If you are configuring a swarm, everything you need is below. Verify your work with
-> `./swarm.sh validate --show-prompts`, which parses the config and launches nothing.
+> `agentainer validate --show-prompts`, which parses the config and launches nothing.
 
 ## Mental model
 
-- One YAML file describes the whole swarm. `./swarm.sh up` reads it and, for each agent:
+- One YAML file describes the whole swarm. `agentainer up` reads it and, for each agent:
   creates `<root>/<name>/`, installs a turn-completion hook in that folder, opens a tmux
   session named `<session_prefix><name>`, runs the agent's `command` inside the folder,
   waits for its input box to become responsive, then types the assembled first prompt in.
@@ -223,23 +223,23 @@ Final prompt order: `first_prompt`, then the comms block, then the task notice.
 ## Commands
 
 ```
-./swarm.sh up [--only a,b] [--restart] [--no-prompt] [--attach]
-./swarm.sh down [--only a,b]
-./swarm.sh restart
-./swarm.sh status
-./swarm.sh attach <agent>
-./swarm.sh send --to <agent> [--from <name>] [--file F] [--queue] [--wait]
+agentainer up [--only a,b] [--restart] [--no-prompt] [--attach]
+agentainer down [--only a,b]
+agentainer restart
+agentainer status
+agentainer attach <agent>
+agentainer send --to <agent> [--from <name>] [--file F] [--queue] [--wait]
                              [--wait-timeout S] [--ignore-busy] [--force] "message"
-./swarm.sh broadcast "message"
-./swarm.sh queue <agent> [--clear]
-./swarm.sh idle <agent> [--no-drain]
-./swarm.sh inbox <agent> [-n N]
-./swarm.sh logs [agent] [-n N] [-f]
-./swarm.sh validate [--show-prompts]
+agentainer broadcast "message"
+agentainer queue <agent> [--clear]
+agentainer idle <agent> [--no-drain]
+agentainer inbox <agent> [-n N]
+agentainer logs [agent] [-n N] [-f]
+agentainer validate [--show-prompts]
 ```
 
 Config resolution: `-c PATH`, else `$SWARM_CONFIG`, else `./agents.yaml`, else the
-`agents.yaml` beside `swarm.sh`. `./swarm.sh x.yaml` is shorthand for `up -c x.yaml`.
+`agents.yaml` beside `agentainer`. `agentainer x.yaml` is shorthand for `up -c x.yaml`.
 
 ## What an agent sees at runtime
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentainer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run a configurable swarm of coding-agent CLIs (Claude Code, Codex, Gemini) in tmux and let them talk to each other.",
   "keywords": [
     "agents",
@@ -32,7 +32,7 @@
     "lib/*.py",
     "hooks/*.sh",
     "scripts/check-deps.js",
-    "swarm.sh",
+    "agentainer",
     "examples/*.yaml",
     "agents.example.yaml",
     "README.md",