소개
agwinterm은 AI 코딩 에이전트를 위해 특별히 설계된 네이브 Windows 터미널입니다. 이 프로그램은 umputun의 agterm에 대한 데뷔 및 포트로, Windows 사용자에게 동일한 에이전트 중심 워크플로우를 제공하기 위해 처음부터 작성되었습니다. C#과 Win32/Direct2D 스택으로 구축된 빠르고 강력한 셸 환경을 제공합니다.
상세정보
에이전트 중심 설계
- 작업 공간 → 세션 → 패인 구조: 사용자 정의 사이드바에서 드래그로 순서 변경, 이름 변경, 플래그 지정, 초점 이동이 가능합니다.
- 대시보드 (Ctrl+Shift+D): 실시간 세션 미리보기 그리드를 통해 빠르게 탐색하고 전환할 수 있습니다.
- 에이전트 상태 표시: 세션별로 유휴/활성/차단/완료 상태를 색상 점과 타이틀 바 벨을 통해 표시합니다.
- Claude Code 세션 바인딩 및 자동 복원: 설치 시 투명한 claude 래퍼를 추가하여 세션 ID를 패인에 연결합니다. 재시작 시 각 패인의 대화가 자동으로 복원됩니다.
- agwinterm 자체 업데이트: GitHub에서 새 릴리스를 감지하고, SHA-256 검증 후 자동으로 다운로드 및 업데이트합니다.
- 실행 스크립트 제어 API: agwintermctl CLI를 통해 모든 언어에서 제어할 수 있습니다.
강력한 Windows 터미널 기능
- 기본 터미널 애플리케이션: 설정에서 agwinterm을 등록하면 모든 콘솔 앱이 agwinterm 세션으로 열립니다.
- 고성능: 약 33,000줄/초의 지속적인 출력과 0.4초의 냉 시작 시간을 제공합니다.
- 고급 그래픽 및 입력 지원: Sixel + Kitty 그래픽, win32 입력 모드, 다채로운 테마(약 580개)를 지원합니다.
접근성 및 편의성
- 화면 읽기 지원: Narrator/NVDA와 같은 화면 읽기 프로그램과 완전히 통합되어 있습니다.
- 사용자 정의 테마: 약 580개의 번들 테마와 사용자 정의 테마를 지원하며, Windows 라이트/다크 모드를 자동으로 따릅니다.
- 유연한 레이아웃: 세션 분할, 빠른 터미널, 오버레이, 다중 창을 지원합니다.
다운로드·설치 방법
GitHub 릴리스 페이지에서 두 가지 옵션을 제공합니다:
- agwinterm-setup-0.17.4.exe: 사용자별 설치 프로그램으로, 시작 메뉴 바로가기와 제거 프로그램을 포함합니다.
- agwinterm-portable-0.17.4-win-x64.exe: 포터블 버전으로, 어디서든 실행할 수 있는 단일 독립 실행 파일입니다.
패키지 매니저를 통해서도 설치할 수 있습니다:
- Scoop:
scoop bucket add agwinterm https://github.com/yeroo/scoop-bucket && scoop install agwinterm - winget:
winget install yeroo.agwinterm - Chocolatey:
choco install agwinterm
설치 후 설정 → 일반에서 통합을 옵트인할 수 있습니다.
기본 사용법/명령어
agwintermctl CLI를 통해 스크립팅할 수 있습니다. 주요 명령어 예시:
agwintermctl tree --json: 작업 공간/세션 트리를 JSON 형식으로 출력합니다.agwintermctl session split on --axis horizontal: 패인을 수평으로 분할합니다.agwintermctl session status blocked --sound: 에이전트 상태를 ‘차단됨’으로 보고하고 소리를 재생합니다.agwintermctl theme set "Tokyo Night": 전체 창의 테마를 변경합니다.
세션 내에서 AGWINTERM_SESSION_ID, AGWINTERM_WINDOW_ID, AGWINTERM_PIPE 환경 변수를 사용할 수 있습니다.
이런 경우에 유용합니다
- AI 코딩 에이전트(Claude Code, Codex 등)와 함께工作效率を最大化したい開発者
- 여러 세션과 작업 공간을 효율적으로 관리해야 하는 프로젝트
- 스크립트와 자동화를 통해 터미널 워크플로우를 제어하려는 사용자
- 접근성 기능이 필요한 사용자(화면 읽기 프로그램 지원)
지원 환경·시스템 요구사항
- 플랫폼: Windows x64
- .NET 런타임 불필요(self-contained)
- 관리자 권한 불필요
최신 버전·업데이트
최신 버전은 0.17.4이며, 앱 내에서 ‘Update agwinterm’ 명령을 사용하거나 agwintermctl app update를 실행하여 업데이트할 수 있습니다.
제한 사항·확인 사항
- 바이너리가 현재 서명되지 않아 SmartScreen에서 첫 실행 시 경고가 표시될 수 있습니다. ‘자세히 정보 > 실행’을 선택해야 합니다.
- winget 및 Chocolatey는 체크포인트 릴리스(패치 번호가 9의 배수인 버전)만 제공합니다.
- 보다 가벼운 대안으로 agliteterm이 있습니다(오래된 또는 RAM이 적은 머신용).
화면으로 보는 주요 기능
agwinterm 사용자 인터페이스

이미지에는 agwinterm이라는 터미널 애플리케이션의 사용자 인터페이스가 보입니다. 화면은 두 개의 패널로 나뉘어 있으며, 각 패널은 Windows PowerShell 세션을 실행하고 있습니다. 왼쪽 패널의 타이틀 바에는 'pwsh', 'master', '71 ~6' 등의 텍스트와 함께 시간과 날짜가 표시되어 있습니다. 오른쪽 패널의 타이틀 바에도 비슷한 정보가 있으며, 'in'이라는 디렉토리 경로가 표시되어 있습니다. 두 패널 모두 'Source → agwinterm' 경로를 나타내는 명령 프롬프트를 보여주고 있습니다.
시스템 요구사항
별도의 .NET 런타임이 필요하지 않습니다. 빌드를 위해서는 .NET 10 SDK가 필요합니다.


