code-agent: implement issue 2

Approval-Correlation: 49036599e5df8e265ad6146109634e40
Plan-SHA256: 8b8371814cb3da5d7a9f2136053f543d1f524824ce1d3f1fe307cfe56c583784
Base-SHA: d2f8326a1a

README.md

@@ -1,2 +1,25 @@
 # gitea-agent-testbed
 
+Python 3.11 이상에서 실행하는 Textual 기반 대화형 TUI 스캐폴드입니다. 입력한 문자열을 세션 내 대화 영역에 누적 표시하며, LLM이나 외부 API는 호출하지 않습니다.
+
+## 설치
+
+```bash
+python -m pip install -e '.[test]'
+```
+
+## 실행
+
+```bash
+chat-tui
+# 또는
+python -m chat_tui
+```
+
+입력창에서 메시지를 입력하고 Enter를 누르면 대화 영역에 표시됩니다. `Escape` 또는 `Ctrl+Q`로 종료합니다.
+
+## 테스트
+
+```bash
+python -m unittest discover -s tests -v
+```