터미널은 개발자의 본거지입니다. 수십 년간 vim, tmux, zsh 같은 도구들이 이 공간을 지배해왔죠. 그런데 최근 AI 코딩 에이전트들이 등장하면서, 터미널은 단순한 명령줄 입력창을 넘어 **‘AI와의 대화 공간’**으로 진화하고 있습니다.
이러한 흐름의 가장 앞선 형태가 바로 Toad입니다. Textual 프레임워크 창시자이자 Rich 라이브러리 개발자인 Will McGugan이 만든 이 도구는, 터미널을 AI 에이전트의 완전한 통합 환경으로 탈바꿈시킵니다.
1. 왜 ‘또 다른’ AI 인터페이스인가?
이미 Claude Code, Gemini CLI, OpenHands 같은 훌륭한 AI 코딩 도구들이 존재합니다. 굳이 Toad가 필요한 이유는 무엇일까요?
기존 도구들의 한계
- 파편화된 경험: 각 에이전트마다 별도의 터미널 탭이나 세션 필요
- 단절된 셸:
!명령어로 셸을 실행해도 환경 변수나 디렉토리 변경이 유지되지 않음 - 제한적 UI: 대부분 단순 텍스트 출력, 인터랙티브 명령은 불가능
- 마크다운 렌더링 부재: 코드 블록, 테이블 등이 제대로 표시되지 않음
Toad의 해결책
Toad는 이 모든 문제를 단일 TUI(Terminal User Interface) 내에서 해결합니다. 마치 tmux가 여러 터미널 세션을 관리하듯, Toad는 여러 AI 에이전트를 관리합니다.
2. 핵심 기능: 터미널을 넘어선 경험
🎯 AI ‘앱스토어’
Toad UI 내에서 수십 개의 AI 에이전트를 검색, 설치, 실행할 수 있습니다.
| 지원 에이전트 (2026년 3월 기준) |
|---|
| Claude Code, Gemini CLI, OpenHands, Codex, 그 외 다수 |
ACP(Agent Client Protocol) 덕분에 새로운 에이전트도 쉽게 추가할 수 있습니다. 개발자는 자신의 에이전트를 ACP로 구현하기만 하면 Toad에서 즉시 실행 가능합니다.
🖥️ 진정한 셸 통합
대부분의 터미널 기반 AI 도구는 ! 문자로 셸 명령을 실행할 수 있지만, 이는 진정한 셸이 아닙니다. 디렉토리를 변경해도 다음 명령에서는 초기화되고, 대화형 프로그램은 실행조차 안 되죠.
Toad는 다릅니다:
- 완전한 셸: cd, export 등의 명령이 세션 전체에 유지
- 풀컬러 출력: ANSI 컬러, 이모지, 유니코드 완벽 지원
- 인터랙티브 명령: htop, vim, 심지어 다른 TUI 앱까지 실행 가능
- 탭 완성: 셸의 탭 완성 기능을 그대로 계승
이는 터미널 기반 AI 코딩 도구 중 유일하게 제공하는 기능입니다.
✍️ 마크다운 프롬프트 에디터
프롬프트를 작성하는 경험 자체가 다릅니다.
- 실시간 마크다운 하이라이팅: 작성 중인 텍스트가 즉시 렌더링
- 코드 펜스 신택스 하이라이팅: 닫기 전부터 언어별 색상 적용
- 마우스 지원: 클릭, 드래그, 복사/붙여넣기 모두 가능
- 다양한 키바인딩: vim 스타일 단축키도 지원
📁 퍼지 파일 피커
@ 문자를 입력하면 프로젝트 파일을 검색할 수 있습니다.
- 스마트 검색: 파일명의 일부만 입력해도 찾아줌
- .gitignore 존중: 버전관리에서 제외된 파일은 자동 필터링
- 트리 뷰 전환: Tab 키로 인터랙티브 파일 탐색기로 전환
3. 기술적 우아함: Will McGugan의 시그니처
Toad는 Will McGugan이 만든 Textual 프레임워크 위에 구축되었습니다. 이는 단순한 기술적 선택이 아닙니다.
Textual의 철학
Textual는 “터미널을 GUI처럼” 만드는 Python 프레임워크입니다. Will McGugan은 이미 Rich(아름다운 터미널 출력)와 Textual(터미널 GUI)로 터미널 생태계를 혁신한 인물입니다.
Toad는 이 두 프로젝트의 정점입니다:
- 빠른 마크다운 스트리밍: 대용량 문서도 끊김 없이 렌더링
- 반응형 레이아웃: 터미널 크기에 맞춰 자동 조정
- 접근성: 스크린 리더 지원, 고대비 모드
아름다운 Diff 뷰어
코드 변경사항을 사이드바이사이드 또는 통합 뷰로 확인할 수 있습니다. 대부분의 언어에 대한 신택스 하이라이팅을 지원하여, 변경된 코드를 한눈에 파악할 수 있습니다.
우아한 마크다운 렌더링
마크다운은 LLM(AI)의 언어입니다. Toad의 스트리밍 마크다운 지원은 신택스 하이라이팅된 코드 펜스, 우아한 테이블, 인용문, 리스트 등을 완벽하게 표시합니다. 다른 도구들은 마크다운을 렌더링하지 않거나 불완전하게 처리하는 경우가 많지만, Toad는 완벽한 마크다운 경험을 제공합니다.
4. 실전 활용: 일상 개발 워크플로우
Toad는 단순한 ‘뷰어’가 아닙니다. 실제 개발 워크플로우의 중심입니다.
시나리오: 기능 개발
- Toad 실행:
toad ~/my-project - 에이전트 선택: Claude Code로 새 기능 구현 요청
- 실시간 검토: 생성된 코드의 diff를 사이드바이사이드로 확인
- 셸로 전환:
!없이 바로git diff실행 - 다른 에이전트 호출: Ctrl+S로 OpenHands로 전환, 리팩토링 요청
- 세션 저장: Ctrl+R로 나중에 이어서 작업
동시 세션 관리
하나의 Toad 인스턴스에서 여러 에이전트를 동시에 실행할 수 있습니다. Claude Code로 백엔드를 작성하면서, Gemini CLI로 문서를 작성하는 식이죠. Ctrl+S를 누르면 모든 에이전트의 상태를 한눈에 볼 수 있습니다.
5. 설치와 시작
설치는 놀라울 정도로 간단합니다:
# 추천 방법
curl -fsSL batrachian.ai/install | sh
# 또는 UV 사용
uv tool install -U batrachian-toad --python 3.14
# 실행
toad시스템 요구사항:
- 지원 OS: Linux, macOS (Windows는 WSL 권장)
- 추천 터미널: Ghostty (최고의 성능과 기능)
- 클립보드 지원: Linux에서는 xclip 설치 필요
마치며: 터미널 중심 AI 개발의 완성
Will McGugan은 블로그에서 이렇게 말했습니다:
“스타트업이 끝나고 자금이 바닥났지만, 제게는 아주 특별한 기술이 있습니다. 터미널을 GUI처럼 보이게 만드는 기술이죠.”
Toad는 이 기술의 정수입니다. 단순히 여러 AI 에이전트를 모아놓은 래퍼가 아닙니다. 터미널 워크플로우와 AI의 완벽한 결합을 목표로 하며, 그 목표를 상당 부분 달성했습니다.
2026년 현재, 터미널은 여전히 개발자의 주된 작업 공간입니다. Toad는 이 공간을 AI 시대에 맞게 진화시킨, 가장 앞선 시도입니다. 만약 터미널을 떠날 수 없는 개발자라면, Toad는 필수 도구가 될 것입니다.
“터미널은 죽지 않았습니다. AI와 함께 더 강해졌을 뿐이죠.”
🔗 관련 정보
- 웹사이트: https://batrachian.ai
- GitHub: https://github.com/batrachianai/toad
- 개발자: Will McGugan (Textual, Rich 창시자)
- 릴리즈 발표: Toad Released
- 지원 프로토콜: ACP (Agent Client Protocol)