Skip to content

Commit 6eb350e

Browse files
committed
chore: remove dead tests and docs for removed TUI auto-open feature (#1116)
Clean up after Wave 1 (#1112, #1113) which removed TUI auto-open functions. - Delete test_tmux_sidebar.py (tests for removed functions) - Remove TestCloseTuiSidebar from test_stop.py - Remove test_sets_auto_tui_to_zero from test_session_start_hud.py - Remove auto-launch sections from tui-troubleshooting docs (en + ko) - Delete obsolete wave3-auto-install plan doc Closes #1116
1 parent d179490 commit 6eb350e

6 files changed

Lines changed: 1 addition & 435 deletions

File tree

docs/ko/tui-troubleshooting.md

Lines changed: 0 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -2,37 +2,6 @@
22

33
이 가이드는 codingbuddy MCP 서버에서 TUI 에이전트 모니터를 실행할 때 발생하는 일반적인 문제를 해결하는 데 도움을 줍니다.
44

5-
## 자동 실행 문제
6-
7-
### TUI 창이 열렸다가 즉시 닫힘
8-
9-
**증상:** Claude Code에 codingbuddy MCP가 설정된 상태로 시작하면 터미널 창이 잠깐 나타났다가 사라집니다.
10-
11-
**원인:** `TuiAutoLauncher`가 PATH에서 `codingbuddy` 바이너리를 찾을 수 없습니다.
12-
13-
**진단:**
14-
15-
```bash
16-
# codingbuddy가 PATH에 있는지 확인
17-
which codingbuddy
18-
19-
# 인스턴스 레지스트리 확인
20-
cat ~/.codingbuddy/instances.json
21-
22-
# MCP 서버가 실행 중인지 확인
23-
ps aux | grep codingbuddy
24-
25-
# 디버그 출력으로 TUI 수동 실행
26-
npx codingbuddy tui
27-
```
28-
29-
**해결 방법:**
30-
31-
- **최신 버전으로 업데이트**: 자동 실행기가 바이너리 경로를 자동으로 해결합니다 (v4.2.0에서 수정됨).
32-
- **전역 설치**: `npm install -g codingbuddy`
33-
- **수동 실행**: `npx codingbuddy tui`
34-
- **자동 실행 비활성화**: `~/.claude/settings.json`의 env 섹션에서 `CODINGBUDDY_AUTO_TUI` 제거.
35-
365
### "No running codingbuddy MCP server found" 오류
376

387
**증상:** `codingbuddy tui` 또는 `npx codingbuddy tui` 실행 시 이 오류가 표시됩니다.
@@ -83,28 +52,6 @@ ps aux | grep codingbuddy
8352
- npx 사용자: 최신 배포 버전을 사용하고 있는지 확인합니다.
8453
- 로컬 개발: `apps/mcp-server/`에서 `yarn build && yarn build:tui` 실행.
8554

86-
### 자동 실행 환경 변수 참조
87-
88-
| 변수 | 목적 | 기본값 |
89-
|------|------|--------|
90-
| `CODINGBUDDY_AUTO_TUI` | 새 터미널 창에서 TUI 자동 실행 활성화 | 미설정 (비활성) |
91-
| `CODINGBUDDY_PROJECT_ROOT` | 인스턴스 레지스트리의 프로젝트 루트 | `process.cwd()` |
92-
| `MCP_DEBUG` | stderr로 디버그 로깅 활성화 | 미설정 (비활성) |
93-
94-
**`.mcp.json`에서 디버그 로깅 활성화:**
95-
96-
```json
97-
{
98-
"codingbuddy": {
99-
"command": "npx",
100-
"args": ["codingbuddy", "mcp", "--tui"],
101-
"env": {
102-
"MCP_DEBUG": "1"
103-
}
104-
}
105-
}
106-
```
107-
10855
## 아이콘이 박스 또는 물음표로 표시됨
10956

11057
### 원인

docs/plans/2026-03-28-wave3-auto-install-tmux-sidebar.md

Lines changed: 0 additions & 216 deletions
This file was deleted.

docs/tui-troubleshooting.md

Lines changed: 0 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -503,37 +503,6 @@ wait
503503

504504
Expected: Debug log shows `Graceful shutdown: unmounting TUI...`, then clean exit.
505505

506-
## Auto-Launch Issues
507-
508-
### TUI Window Opens and Immediately Closes
509-
510-
**Symptom:** After starting Claude Code with codingbuddy MCP configured, a terminal window briefly appears and disappears.
511-
512-
**Cause:** `TuiAutoLauncher` cannot find the `codingbuddy` binary in PATH.
513-
514-
**Diagnosis:**
515-
516-
```bash
517-
# Check if codingbuddy is in PATH
518-
which codingbuddy
519-
520-
# Check instance registry
521-
cat ~/.codingbuddy/instances.json
522-
523-
# Check if MCP server is running
524-
ps aux | grep codingbuddy
525-
526-
# Run TUI manually with debug output
527-
npx codingbuddy tui
528-
```
529-
530-
**Solutions:**
531-
532-
- **Update to latest version**: The auto-launcher now resolves the binary path automatically (fixed in v4.2.0).
533-
- **Install globally**: `npm install -g codingbuddy`
534-
- **Run manually**: `npx codingbuddy tui`
535-
- **Disable auto-launch**: Remove `CODINGBUDDY_AUTO_TUI` from `~/.claude/settings.json` env section.
536-
537506
### "No running codingbuddy MCP server found"
538507

539508
**Symptom:** Running `codingbuddy tui` or `npx codingbuddy tui` shows this error.
@@ -584,28 +553,6 @@ ps aux | grep codingbuddy
584553
- For npx users: ensure you're using the latest published version.
585554
- For local development: run `yarn build && yarn build:tui` in `apps/mcp-server/`.
586555

587-
### Auto-Launch Environment Variable Reference
588-
589-
| Variable | Purpose | Default |
590-
|----------|---------|---------|
591-
| `CODINGBUDDY_AUTO_TUI` | Enable auto-launch of TUI in new terminal window | Not set (disabled) |
592-
| `CODINGBUDDY_PROJECT_ROOT` | Project root for instance registry | `process.cwd()` |
593-
| `MCP_DEBUG` | Enable debug logging to stderr | Not set (disabled) |
594-
595-
**Enable debug logging** in `.mcp.json`:
596-
597-
```json
598-
{
599-
"codingbuddy": {
600-
"command": "npx",
601-
"args": ["codingbuddy", "mcp", "--tui"],
602-
"env": {
603-
"MCP_DEBUG": "1"
604-
}
605-
}
606-
}
607-
```
608-
609556
## Related Documentation
610557

611558
- [TUI User Guide](./tui-guide.md) - How to run and configure the TUI

packages/claude-code-plugin/tests/test_session_start_hud.py

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ def home_dir(tmp_path):
3939
def settings_file(home_dir):
4040
"""Path to settings.json in simulated home."""
4141
sf = home_dir / ".claude" / "settings.json"
42-
sf.write_text(json.dumps({"env": {"CODINGBUDDY_AUTO_TUI": "1"}}))
42+
sf.write_text(json.dumps({"env": {}}))
4343
return sf
4444

4545

@@ -105,13 +105,6 @@ def test_skips_if_already_installed(self, home_dir, settings_file, hud_source, m
105105
# command unchanged (not overwritten with full path)
106106
assert data["statusLine"]["command"] == "python3 codingbuddy-hud.py"
107107

108-
def test_sets_auto_tui_to_zero(self, home_dir, settings_file, hud_source, monkeypatch):
109-
monkeypatch.setenv("CLAUDE_PLUGIN_DIR", str(hud_source.parent.parent))
110-
session_start._install_statusline(home_dir, settings_file)
111-
112-
data = json.loads(settings_file.read_text())
113-
assert data["env"]["CODINGBUDDY_AUTO_TUI"] == "0"
114-
115108
def test_noop_when_source_not_found(self, home_dir, settings_file, monkeypatch):
116109
monkeypatch.delenv("CLAUDE_PLUGIN_DIR", raising=False)
117110
# Mock _find_hud_source to return None

0 commit comments

Comments
 (0)