chore: update docs

Author: cs50victor

README.md

@@ -56,7 +56,9 @@ Or add to `~/.config/opencode/opencode.json` (OpenCode):
 - At least one coding agent CLI on PATH:
   - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`claude`)
   - [OpenCode](https://opencode.ai) (`opencode`)
-- For OpenCode teammates: `OPENCODE_SERVER_URL` must be set (for example, `http://localhost:4096`)
+- For OpenCode teammates:
+  - `OPENCODE_SERVER_URL` must be set (for example, `http://localhost:4096`)
+  - the `claude-teams` MCP server must be connected in that OpenCode instance
 
 ## Tools
 
@@ -65,7 +67,7 @@ Or add to `~/.config/opencode/opencode.json` (OpenCode):
 | `team_create` | Create a new agent team. One team per server session. |
 | `team_delete` | Delete a team and all its data. Fails if teammates are still active. |
 | `spawn_teammate` | Spawn a teammate in tmux (pane by default, window when `USE_TMUX_WINDOWS` is set). |
-| `send_message` | Send direct messages, broadcasts, shutdown/plan approval responses. |
+| `send_message` | Send direct messages (teammates to team-lead), broadcasts (team-lead only), and shutdown/plan responses. |
 | `read_inbox` | Read messages from an agent's inbox. |
 | `poll_inbox` | Long-poll an inbox for new messages (up to 30s). |
 | `read_config` | Read team configuration and member list. |
@@ -79,9 +81,9 @@ Or add to `~/.config/opencode/opencode.json` (OpenCode):
 ## How it works
 
 - **Spawning**: Teammates launch in tmux via `tmux split-window` (default) or `tmux new-window` when `USE_TMUX_WINDOWS` is set. Backend can be Claude (`claude`) or OpenCode (`opencode`). Each gets a unique agent ID (`name@team`) and color.
-- **Messaging**: JSON-based inboxes under `~/.claude/teams/<team>/inboxes/`. File locking (`fcntl`) prevents corruption from concurrent reads/writes.
+- **Messaging**: JSON inboxes live under `~/.claude/teams/<team>/inboxes/`. Team lead can message anyone; teammates can message only team lead.
 - **Tasks**: JSON task files under `~/.claude/tasks/<team>/`. Tasks have status tracking, ownership, and dependency management (`blocks`/`blockedBy`).
-- **Concurrency safety**: Atomic writes via `tempfile` + `os.replace` for config. `fcntl` file locks for inbox operations.
+- **Concurrency safety**: Atomic config writes via `tempfile` + `os.replace` (with Windows retry). Cross-platform file locks via `filelock`.
 
 ## Storage layout
 

src/claude_teams/opencode_client.py

@@ -18,7 +18,9 @@ def __init__(
         self.response_body = response_body
 
 
-def _request(method: str, url: str, body: dict | None = None, timeout: int = 15) -> bytes:
+def _request(
+    method: str, url: str, body: dict | None = None, timeout: int = 15
+) -> bytes:
     headers = {"Content-Type": "application/json"}
     data = json.dumps(body).encode() if body is not None else None
     req = urllib.request.Request(url, data=data, headers=headers, method=method)
@@ -36,25 +38,31 @@ def _request(method: str, url: str, body: dict | None = None, timeout: int = 15)
         if status == 400:
             raise OpenCodeAPIError(
                 f"Opencode rejected request to {endpoint}: {body_text or status}",
-                status_code=status, response_body=body_text,
+                status_code=status,
+                response_body=body_text,
             )
         if status == 404:
             raise OpenCodeAPIError(
                 f"Opencode resource not found at {endpoint}",
-                status_code=status, response_body=body_text,
+                status_code=status,
+                response_body=body_text,
             )
         if status >= 500:
             raise OpenCodeAPIError(
                 f"Opencode server error ({status}) on {endpoint}: {body_text}",
-                status_code=status, response_body=body_text,
+                status_code=status,
+                response_body=body_text,
             )
         raise OpenCodeAPIError(
             f"Unexpected response from opencode ({status}) on {endpoint}: {body_text}",
-            status_code=status, response_body=body_text,
+            status_code=status,
+            response_body=body_text,
         )
     except urllib.error.URLError as e:
         if isinstance(e.reason, socket.timeout):
-            raise OpenCodeAPIError(f"Opencode server at {url} timed out after {timeout}s")
+            raise OpenCodeAPIError(
+                f"Opencode server at {url} timed out after {timeout}s"
+            )
         raise OpenCodeAPIError(f"Cannot reach opencode server at {url}: {e.reason}")
     except socket.timeout:
         raise OpenCodeAPIError(f"Opencode server at {url} timed out after {timeout}s")
@@ -64,7 +72,7 @@ def _request(method: str, url: str, body: dict | None = None, timeout: int = 15)
 Cannot spawn opencode teammate: the 'claude-teams' MCP server is not configured \
 (or not connected) in the opencode instance at {server_url}.
 
-Add the following to your opencode MCP config (~/.config/opencode/config.json):
+Add the following to your opencode MCP config (~/.config/opencode/opencode.json):
 
 {{
   "mcp": {{
@@ -141,7 +149,9 @@ def list_agents(server_url: str) -> list[dict]:
     return [
         {"name": a["name"], "description": a.get("description", "")}
         for a in data
-        if isinstance(a, dict) and "name" in a and a.get("description")
+        if isinstance(a, dict)
+        and "name" in a
+        and a.get("description")
         and a["name"] not in _OPENCODE_INTERNAL_AGENTS
     ]