From c20a4f022638648d272b9374b33baa4ffe1e368b Mon Sep 17 00:00:00 2001
From: ArthurErlich <a.erlich@live.de>
Date: Wed, 14 Oct 2026 16:05:20 +0200
Subject: [PATCH] docs: correct usage commands for opencode v2 CLI (--agent
 only on run/mini)

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index abdb510..dd435f3 100644
--- a/README.md
+++ b/README.md
@@ -40,9 +40,12 @@ upstream revision each release carries).
 Start OpenCode with the `pocock` agent selected and describe what you want to build:
 
 ```bash
-opencode --agent pocock
+opencode mini --agent pocock                  # interactive (v2.0.29: --agent is not a top-level flag)
+opencode run --agent pocock "build …" --auto  # one-shot, autonomous
 ```
 
+In the default TUI (plain `opencode`), switch to `pocock` with the agent picker instead.
+
 | Agent             | Role                                                                                                                                                                                                                                        |
 | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `pocock`          | Primary orchestrator. Routes with `ask-matt`, walks grill → spec → tickets → build → review → retro, proposes before each user-invoked step, runs `implement-spec` with one git worktree per ticket and parallel `pocock-worker` subagents. |