From 08ac82113f1b859c6f27350cc78baf13ee08d33d Mon Sep 17 00:00:00 2001
From: umutcagand <c8dhjp4tyv@privaterelay.appleid.com>
Date: Mon, 24 Aug 2026 00:07:43 +0300
Subject: [PATCH 1/3] docs: remove broken development guide link

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d1d2761852..adebad1dad 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,7 @@ Start the CLI separately with:
 bun start-cli
 ```
 
-See the [Contributing Guide](./CONTRIBUTING.md), [development guide](./docs/development.md), and [testing guide](./docs/testing.md) for environment setup and the checks to run before opening a pull request.
+See the [Contributing Guide](./CONTRIBUTING.md) and [testing guide](./docs/testing.md) for environment setup and the checks to run before opening a pull request.
 
 ## Built on Codebuff
 

From 4426d5a22553cb4f077805f7bbd01edd4606b593 Mon Sep 17 00:00:00 2001
From: umutcagand <c8dhjp4tyv@privaterelay.appleid.com>
Date: Mon, 24 Aug 2026 00:09:39 +0300
Subject: [PATCH 2/3] docs: remove broken development guide links

---
 README.zh-CN.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.zh-CN.md b/README.zh-CN.md
index c4e500d93f..b10c6ae011 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -89,7 +89,7 @@ bun up
 bun start-cli
 ```
 
-环境配置及提交拉取请求前应运行的检查，请参阅[贡献指南](./CONTRIBUTING.md)、[开发指南](./docs/development.md)和[测试指南](./docs/testing.md)。
+环境配置及提交拉取请求前应运行的检查，请参阅[贡献指南](./CONTRIBUTING.md)和[测试指南](./docs/testing.md)。
 
 ## 基于 Codebuff 构建
 

From ed41733eb645363bd3420bcebdd2712a4dd5c1ca Mon Sep 17 00:00:00 2001
From: umutcagand <c8dhjp4tyv@privaterelay.appleid.com>
Date: Mon, 24 Aug 2026 00:10:48 +0300
Subject: [PATCH 3/3] docs: add tmux CLI testing guide

---
 cli/tmux.knowledge.md | 96 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 cli/tmux.knowledge.md

diff --git a/cli/tmux.knowledge.md b/cli/tmux.knowledge.md
new file mode 100644
index 0000000000..5d16f9392d
--- /dev/null
+++ b/cli/tmux.knowledge.md
@@ -0,0 +1,96 @@
+# tmux CLI testing notes
+
+The CLI's interactive tests use [tmux](https://github.com/tmux/tmux) so they
+can run the TUI in a real terminal session and capture the rendered pane.
+
+## Install tmux
+
+```bash
+# macOS
+brew install tmux
+
+# Ubuntu/Debian
+sudo apt-get install tmux
+
+# Windows
+wsl --install
+sudo apt-get install tmux
+```
+
+## Run the proof of concept
+
+From the `cli/` directory:
+
+```bash
+bun run test:tmux-poc
+```
+
+The proof of concept creates a detached session, starts the CLI with
+`--help`, captures the pane, checks the help output, and removes the session
+when it finishes.
+
+## Send input correctly
+
+OpenTUI expects pasted text to be wrapped in bracketed-paste markers. A plain
+`send-keys` call can drop characters, so use `-l` and the markers around the
+text:
+
+```bash
+tmux send-keys -t SESSION -l $'\e[200~hello world\e[201~'
+```
+
+The same pattern in TypeScript is:
+
+```ts
+await tmux([
+  'send-keys',
+  '-t',
+  sessionName,
+  '-l',
+  `\x1b[200~${text}\x1b[201~`,
+])
+```
+
+Press Enter separately when the test needs to submit the input.
+
+## Useful tmux commands
+
+```bash
+# Start a detached session with a fixed pane size
+tmux new-session -d -s cli-test -x 120 -y 30
+
+# Capture the current pane as plain text
+tmux capture-pane -t cli-test -p
+
+# Inspect active sessions
+tmux list-sessions
+
+# Always clean up a test session
+tmux kill-session -t cli-test
+```
+
+Use a unique session name in automated tests so a stale session from an
+earlier run cannot affect the current one. The integration tests also clean up
+their sessions in `finally` blocks.
+
+## Run the integration tests
+
+From the `cli/` directory, build the SDK first and then run the tmux suite:
+
+```bash
+bun run --cwd ../sdk build
+bun test src/__tests__/integration-tmux.test.ts
+```
+
+The suite skips itself when tmux or the built SDK is unavailable. When a tmux
+server is already running, the tests copy the CLI test environment into its
+global environment before starting a session.
+
+## Troubleshooting
+
+- Capture output with `tmux capture-pane -t SESSION -p` before attaching; this
+  keeps the test output reproducible and easy to assert on.
+- If a test is interrupted, run `tmux list-sessions` and remove its stale
+  session with `tmux kill-session -t SESSION`.
+- Keep the pane at least 120 columns wide and 30 rows high, matching the
+  proof-of-concept defaults, so help and status output do not wrap differently.