Agentty/문서

소개

Agentty가 무엇이고 누구를 위한 도구인지 — 여러 AI 에이전트를 동시에 돌리기 위해 만든 네이티브 터미널.

Agentty는 AI 코딩 에이전트를 돌리는 사람을 위한 터미널입니다. 터미널이 하는 일(셸, 탭, 분할, 스크롤백)을 그대로 하면서 두 번째 에이전트가 움직이는 순간부터 필요해지는 것을 더합니다. 프로젝트별 자리, 에이전트별 상태, 무엇을 바꿨는지 보는 방법, 그리고 누군가 나를 기다릴 때 오는 알림입니다.

Rust로 작성되고 GPU로 렌더링되는 네이티브 애플리케이션입니다. Electron도, 터미널을 감싼 웹뷰도, 만들어야 할 계정도 없습니다.

무엇을 위한 도구인가#

에이전트 하나를 돌리는 건 쉽습니다. 터미널에서 claude를 실행하고 지켜보면 됩니다. 다섯 개가 되면 터미널이 더는 도와주지 않습니다. 탭은 전부 똑같이 생겼습니다. 어느 쪽이 답을 기다리는지 놓치고, 두 에이전트가 같은 파일을 고칩니다. 비용은 청구서가 올 때까지 보이지 않습니다.

Agentty는 그 두 번째 상황을 위해 만들어졌습니다.

  • 누가 나를 기다리는지 항상 알 수 있습니다. 워크스페이스마다 에이전트가 작업 중인지, 끝났는지, 입력을 기다리는지가 표시됩니다. 답이 필요하면 페인 테두리가 켜지고, 다른 일을 하고 있으면 알림이 옵니다.
  • 에이전트끼리 부딪히지 않습니다. 같은 프로젝트의 두 번째 세션은 자기만의 git 워크트리와 브랜치에서 시작하므로, 두 에이전트가 같은 파일을 건드리는 일이 없습니다.
  • 작업 내용이 눈에 보입니다. GitHub Desktop 형태의 git 페이지, 모든 워크트리를 보여주는 파일 패널, 그리고 이미 디스크에 있는 대화 기록으로 만든 사용량 대시보드가 있습니다.

Agentty는 FDE(Forward Deployed Engineer, 전방 배치 엔지니어)가 일하는 방식으로도 넓혀 가고 있습니다. 플러그인이 환경과 상황마다 맞는 에이전트를 만들고, Agentty는 그 에이전트가 모두 실행되는 하나의 일관된 환경이 됩니다.

핵심 개념#

워크스페이스 → 탭 → 분할#

워크스페이스는 하나의 프로젝트입니다. 폴더 하나, 사이드바의 행 하나, 그리고 그 프로젝트에 열어 둔 모든 것입니다. 워크스페이스 안에 탭이 있고, 탭은 분할해서 여러 페인으로 나눌 수 있습니다. 페인은 셸이거나, AI 에이전트이거나, 파일 편집기이거나, 브라우저입니다.

워크스페이스는 그룹으로 묶고 순서를 바꿀 수 있습니다. 다시 시작하면 종료할 때 모습 그대로 돌아옵니다.

페인은 껍데기가 아니라 실제 프로그램입니다#

에이전트 페인은 실제 명령줄 도구를 실행합니다. claude, codex, 또는 설치해 둔 다른 에이전트가 진짜 PTY 위에서 돌아갑니다. Agentty는 상태를 보고받을 훅을 넘기고 그 도구가 어차피 기록하는 대화 파일을 읽을 뿐입니다. 대화를 중계하지 않고, 설정 파일을 고쳐 쓰지 않으며, 에이전트와 제공자 사이에 끼어들지 않습니다.

그래서 에이전트는 Agentty 안에서도 원래 터미널에서와 똑같이 동작합니다. 에이전트 CLI를 업그레이드할 때 Agentty의 릴리스를 기다릴 필요도 없습니다.

모든 것이 로컬입니다#

Agentty에는 백엔드가 없습니다. 세션 목록, 검색, 사용량 수치, 비용 추정, 컨텍스트 문서는 전부 이용자 컴퓨터의 파일로 만들어집니다. 대화, 코드, 자격 증명은 당사의 서버를 거치지 않습니다. 애초에 그런 서버가 없기 때문입니다.

Agentty에 맡긴 비밀 값은 운영체제의 자격 증명 저장소에 들어갑니다. macOS는 키체인, Windows는 자격 증명 관리자, Linux는 Secret Service입니다.

Note

이용자가 실행하는 에이전트 CLI는 각자의 제공자와 통신합니다. Claude Code는 Anthropic과, Codex는 OpenAI와, 이용자 본인의 계정으로 컴퓨터에서 직접 통신합니다. 다른 터미널에서와 똑같습니다. Agentty는 그 사이에 끼지 않아 중계하지도 내용을 받지도 않습니다. 그 통신에는 각 제공자의 약관과 개인정보처리방침이 적용됩니다. Agentty 자체가 보내는 것은 사용 통계에 정리돼 있습니다.

나아가는 방향#

FDE(Forward Deployed Engineer, 전방 배치 엔지니어)는 고객의 현장에 들어가, 그 환경에 필요한 것 — 그곳의 도구, 데이터, 규칙 — 을 직접 만들어 내는 엔지니어입니다. 범용 제품 하나를 건네는 대신 현장에 맞춘 것을 만듭니다. Agentty는 AI 에이전트를 이 관점으로 확장하려 합니다.

에이전트 하나로 모든 팀, 모든 기술 스택, 모든 상황에 맞출 수는 없습니다. 그래서 역할을 둘로 나눕니다.

  • 플러그인은 환경과 상황에 맞는 에이전트를 만듭니다. 업무별 스킬과 규칙(AgentOS), 다루는 도구와 사이트, 따르는 단계와 완료 기준, 허용하는 권한을 팀·고객·상황 단위로 한 번에 묶습니다.
  • Agentty는 모든 에이전트를 하나의 일관된 환경에서 실행합니다. 어떤 플러그인이 어떤 에이전트를 움직이든, 같은 터미널, 세션, git 워크트리, 인앱 브라우저, 데이터베이스, 컨테이너, 자격 증명 저장소, 사용량, 알림 위에서 돌아갑니다.

그래서 서로 전혀 다른 환경에 맞춘 에이전트가 하나의 일관된 곳에서 나란히 돌아갑니다. 각 단계는 읽고 이어받을 수 있는 실제 에이전트 세션입니다. 플러그인은 무엇을 할 수 있는지 먼저 밝힙니다. 현장에서 만든 것은 플러그인으로 배포되어 어느 Agentty에서든 실행됩니다.

지금도 플러그인은 패널과 자동화 작업공간을 더하고 선언한 사이트에서 인앱 브라우저를 다룹니다. AgentOS 플러그인은 에이전트 세션으로 일을 진행합니다. 플러그인 API는 이 방향으로 계속 넓어집니다. 플러그인을 참고하세요.

제공하는 기능#

영역내용
에이전트 상태워크스페이스별 실시간 상태, 답을 기다리는 페인의 테두리 표시, 알림과 알림 센터, 최근 미확인으로 이동
채팅 보기CLI는 그대로 실행한 채 Claude Code·Codex를 데스크톱 앱 같은 채팅으로 — 채팅 보기 참고
세션~/.claude와 ~/.codex 세션 탐색·재개, 제목이나 내용으로 검색, Claude와 Codex 사이의 대화 이전
오케스트레이션목표 하나를 적으면 오케스트레이터가 에이전트 팀을 짜서 웨이브로 실행하고 결과를 검수받음. 한 에이전트에서 다른 에이전트로 선을 끌어 컨텍스트 공유(라이브로 지정하면 이후의 모든 턴을 자동 전달)
Git저장소·브랜치 전환, fetch·pull·push, 변경 사항 검토, 선택한 파일만 커밋, 히스토리 탐색, 병합
워크트리세션마다 하나의 워크트리, 모든 트리와 작업자와 변경 내용을 보여주는 패널
파일과 편집기프로젝트 트리, 구문 강조·포매터·언어 서버(정의와 사용처로 이동, 자동 완성, 문제 표시, 빠른 수정, 이름 바꾸기)를 갖춘 편집기, 표로 편집하는 CSV·TSV·Excel, 문단 단위로 편집하는 Word 문서, VS Code·Cursor로 열기
확장Claude Code와 Codex의 스킬·서브에이전트·명령·플러그인·MCP 서버를 한자리에서
모니터링로컬 대화 기록으로 계산한 비용·토큰·캐시 적중률·모델, 실행 중인 AI 프로세스
휴지통삭제한 작업공간은 7일(또는 정한 기간) 동안 휴지통에 남고 복원 가능 — 모니터링 참고
원격 접속Tailscale 네트워크의 다른 기기에서 터미널과 작업공간 열기 — 원격 접속 참고
플러그인패널, 버튼, 팔레트 명령, 다른 앱에서 오는 agentty:// 링크 — 플러그인 참고

지원 플랫폼#

Agentty는 macOS, Windows, Linux용으로 만들어졌으며 기준 플랫폼은 macOS입니다. 세 플랫폼 모두 릴리스 페이지에서 내려받을 수 있습니다. 나머지 둘도 AppKit이나 WebKit에 의존하지 않는 기능은 모두 똑같이 제공합니다. 차이는 플랫폼에 정리돼 있습니다.

라이선스#

Agentty는 계정도 구독도 없이 무료로 사용할 수 있습니다. Apache License 2.0 오픈소스이며, 소스는 github.com/empty-user77/Agentty에 있습니다.

다음으로#