From 4ed4d75a679ffc996cdeafce26e528d8ea437bc2 Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Fri, 29 May 2026 16:09:02 -0700
Subject: [PATCH] feat(agent-queue): default max concurrency 2->3 (still
 env/flag configurable)

- AGENT_QUEUE_MAX default 3 (override via env or run --max N)
- sync README quick-start + env table + bytelyst-cli example to --max 3
---
 agent-queue/README.md      | 8 ++++----
 agent-queue/agent-queue.sh | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/agent-queue/README.md b/agent-queue/README.md
index 9366abf..e6cf8a5 100644
--- a/agent-queue/README.md
+++ b/agent-queue/README.md
@@ -43,8 +43,8 @@ chmod +x agent-queue.sh
   --cwd /Users/sd9235/code/mygh/learning_ai_common_plat/dashboards/tracker-web \
   --yolo
 
-# start processing (foreground; Ctrl-C to stop). Run up to 2 agents at once.
-./agent-queue.sh run --max 2
+# start processing (foreground; Ctrl-C to stop). Run up to 3 agents at once (default).
+./agent-queue.sh run --max 3
 ```
 
 In a **second terminal**, watch progress:
@@ -129,7 +129,7 @@ queue is refused while the first is alive (a stale `daemon.pid` is cleared).
 Wired into the repo's unified CLI (no GitHub token required for this subcommand):
 
 ```bash
-./bytelyst-cli.sh agent-queue run --max 2     # full passthrough
+./bytelyst-cli.sh agent-queue run --max 3     # full passthrough
 ./bytelyst-cli.sh aq status                   # short alias
 ```
 
@@ -157,7 +157,7 @@ queue/
 | Var | Default | Meaning |
 | --- | ------- | ------- |
 | `AGENT_QUEUE_ROOT` | `./queue` | where the kanban folders live |
-| `AGENT_QUEUE_MAX` | `2` | max concurrent agents |
+| `AGENT_QUEUE_MAX` | `3` | max concurrent agents (override per-run with `run --max N`) |
 | `AGENT_QUEUE_ENGINE` | `devin` | default engine when none in frontmatter |
 | `AGENT_QUEUE_POLL` | `3` | inbox poll interval (seconds) |
 | `AGENT_QUEUE_VERIFY` | _(empty)_ | default auto-QA verify command; per-job `verify:` overrides it |
diff --git a/agent-queue/agent-queue.sh b/agent-queue/agent-queue.sh
index e75ab30..58287db 100755
--- a/agent-queue/agent-queue.sh
+++ b/agent-queue/agent-queue.sh
@@ -40,7 +40,7 @@ STATE="$QUEUE_ROOT/.state"
 LOCKS="$QUEUE_ROOT/locks"
 
 # ── Config (env-overridable) ────────────────────────────────────────
-MAX_CONCURRENCY="${AGENT_QUEUE_MAX:-2}"
+MAX_CONCURRENCY="${AGENT_QUEUE_MAX:-3}"
 DEFAULT_ENGINE="${AGENT_QUEUE_ENGINE:-devin}"
 POLL_SECONDS="${AGENT_QUEUE_POLL:-3}"
 # A running worker is flagged "stalled" if its log has not changed in this many