umputun/agterm

해결하는 문제

표준 탭 기반 터미널에서 여러 장기 실행 AI 코딩 에이전트 세션을 관리하는 것이 어렵고, 어떤 에이전트가 활성화되었는지, 차단되었는지, 완료되었는지 쉽게 잊어버릴 수 있습니다. 이 도구는 이러한 세션을 체계적으로 정리하고, 에이전트가 자체 환경을 제어할 수 있는 프로그래밍 가능한 인터페이스를 제공합니다.

작동 방식

agterm은 Ghostty 엔진을 사용해 구현된 네이티브 macOS 터미널로, 쉘을 이름이 지정된 워크스페이스와 세션으로 정리합니다. agtermctl이라고 불리는 내장 CLI 도구를 통해 로컬 소켓을 통해 완전한 제어 API를 노출하며, 스크립트나 AI 에이전트가 세션을 생성하고, 명령어를 입력하고, 터미널 텍스트를 읽고, 창 레이아웃을 관리할 수 있습니다. 또한 Claude Code나 Codex와 같은 LLM에 설치 가능한 "에이전트 기술"도 포함되어 있어, 에이전트가 이 API를 사용해 터미널을 스스로 제어할 수 있도록 합니다.

대상 사용자

여러 AI 코딩 에이전트를 동시에 실행하고, 프로그래밍으로 제어하고 모니터링할 수 있는 터미널이 필요한 개발자

주요 기능

• 제어 API 및 CLI: agtermctl을 사용해 세션 생성 및 버퍼 읽기 등 터미널을 프로그래밍으로 제어할 수 있습니다.
• 워크스페이스 정리: "work" 또는 "personal"과 같은 이름이 지정된 워크스페이스에 세션을 그룹화하여 컨텍스트 관리를 개선합니다.
• 에이전트 통합: 에이전트가 자신의 레이아웃과 상태 표시기(활성, 차단, 완료)를 관리할 수 있도록 설치 가능한 기술 제공.
• 고급 레이아웃: 스플릿, 스クラ치 터미널, 플로팅 오버레이를 지원하여 기존 쉘을 방해하지 않고 인터랙티브 프로그램을 실행할 수 있습니다.
• 라이브 복원: zmx를 사용해 앱 재시작 후에도 주요 및 스플릿 프로세스를 유지할 수 있습니다.