<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/banner.png" alt="Tellurion: 코딩 에이전트를 위한 macOS 터미널" width="100%">
</p>
<p align="center">
<a href="https://trendshift.io/repositories/282033"><img src="https://trendshift.io/api/badge/trendshift/repositories/282033/daily?language=Zig" alt="Trendshift의 Zig 언어 일일 리포지토리 #1" width="250" height="55"></a>
<a href="https://trendshift.io/repositories/282033"><img src="https://trendshift.io/api/badge/trendshift/repositories/282033/weekly?language=Zig" alt="Trendshift의 Zig 언어 주간 리포지토리 #4" width="250" height="55"></a>
</p>
<p align="center">
<a href="https://github.com/steventsvik/Tellurion/releases/latest"><img alt="최신 릴리스" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/release.svg"></a>
<a href="https://github.com/steventsvik/Tellurion/stargazers"><img alt="GitHub 스타" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/stars.svg"></a>
<a href="https://github.com/steventsvik/Tellurion/releases"><img alt="총 다운로드 수" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/downloads.svg"></a>
<img alt="macOS 13+" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/macos.svg">
<img alt="Apple silicon" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/arm64.svg">
<a href="LICENSE"><img alt="라이선스: AGPL-3.0" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/license.svg"></a>
<a href="https://ghostty.org"><img alt="Ghostty 기반" src="https://raw.githubusercontent.com/steventsvik/Tellurion/badges/ghostty.svg"></a>
<a href="https://github.com/steventsvik/Tellurion/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/steventsvik/Tellurion/actions/workflows/ci.yml/badge.svg?branch=dev"></a>
</p>
<p align="center">
<b><a href="https://github.com/steventsvik/Tellurion/releases/latest">다운로드</a></b> ·
<b><a href="https://steventsvik.github.io/Tellurion/">웹사이트</a></b> ·
<a href="#boards">보드(Boards)</a> ·
<a href="#watch-your-agents-work-live">실시간 에이전트 작업 확인</a> ·
<a href="#features">기능(Features)</a> ·
<a href="#how-it-compares">비교(Compare)</a> ·
<a href="#install">설치(Install)</a> ·
<a href="#keyboard-shortcuts">단축키(Shortcuts)</a> ·
<a href="#security-and-privacy">보안 및 개인정보 보호(Security)</a>
</p>
<p align="center">
<a href="images/readme/demo.mp4"><img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/demo.gif" alt="52초 분량의 런칭 스타일 투어: 플로팅 창에 표시되는 실제 Claude Code 및 Codex 세션, 에이전트가 따라가는 편집기, Mission Control, 검토 받은 편지함(review inbox), Visual Fix, Ollama를 통한 로컬 모델 채팅, 에이전트 경주, 그리고 턴 되돌리기 기능과 장면 사이에 배치된 타이포그래피 기능 카드" width="100%"></a>
</p>
<p align="center"><sub style="font-size: smaller;">실제 앱, 실제 에이전트, 데모 프로젝트. 전체 투어는 GIF로 제공됩니다. <a href="images/readme/demo.mp4">더 높은 품질로 보기</a>.</sub></p>
Tellurion은 Claude Code, Codex, Gemini CLI, Copilot CLI와 같은 여러 AI 코딩 에이전트들을 한 번에 여러 프로젝트에서 실행하는 개발자를 위한 macOS 터미널입니다. 이는 빠른 네이티브 터미널인 Ghostty의 포크(fork) 버전으로, 모든 에이전트가 무엇을 하는지 실시간으로 보여줍니다. 즉, 코드를 작성하는 과정 자체, 프로젝트 내 어느 위치에 있는지, 백엔드의 어떤 부분을 건드리는지, 그리고 언제 사용자가 필요한지를 알려줍니다. 에이전트들은 각 프로젝트에 대해 학습한 내용을 공유하고, 서로 작업을 인계하며, 되돌릴 수 있는 검토 받은 편지함(review inbox)에 변경 사항을 남깁니다. 이들을 탭에서 실행하거나 보드에서 실행할 수 있는데, 여기서 모든 터미널은 타일이며 하나의 카드로 전체 에이전트 팀을 운영할 수 있습니다. 휴대폰으로 답변하고, 사용자의 Mac에서 구동되는 모델과 채팅할 수 있습니다.
Ghostty가 하던 모든 기능은 여전히 작동하며, 사용자의 Ghostty 설정도 그대로 작동합니다. 이 포크는 공식 Ghostty 릴리스를 추적하고 그 위에 자체 기능을 추가했습니다.
Tellurion은 GhosttyEXTREME이라는 이름이었습니다. 동일한 앱이며, 동일한 기능입니다. 만약 GhosttyEXTREME을 설치했다면, '업데이트 확인...'을 통해 Tellurion으로 이동할 수 있습니다.
[!참고]
비공식 포크입니다. Ghostty 프로젝트와는 관련이 없으며 승인되지 않았습니다.
curl -fsSL https://raw.githubusercontent.com/steventsvik/Tellurion/custom/install.sh | bash
<sub>Apple silicon, macOS 13 이상 지원. 무료 오픈 소스(AGPL-3.0). 계정 필요 없음, 원격 측정 기능 없음.</sub>
<br>
보드 (Boards)
1.8 버전에서 새로 추가된 기능입니다: 터미널을 탭 안에 넣는 대신 보드에 배치할 수 있습니다. Tellurion을 처음 열 때 또는 언제든지 **설정(Settings) → 에디션(Edition)**에서 **보드(Board)**를 선택하세요. Classic이 기본값으로 유지되며, 설정을 변경하지 않는 한 아무것도 바뀌지 않습니다.
<p align="center">
<a href="images/readme/boards.mp4"><img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/boards.gif" alt="Tellurion 보드(Boards)의 54초 투어: 네 개의 프로젝트에 걸쳐 열두 개의 에이전트 타일로 구성된 보드가 한 타일로 날아들어와 다시 빠져나오고, 목록에서 Claude Code 권한 프롬프트를 답변하며, 프리셋에서 팀을 생성하고, 에이전트를 오케스트레이터 카드, 미션 맵(Mission Map), 웹 타일, 에이전트 맵(Agent Map) 및 '완료(Done)'로 이동하는 칸반 카드로 연결합니다." width="100%"></a>
</p>
<p align="center"><sub>실제 앱과 데모 프로젝트입니다. Claude Code와 Codex는 실제이며, 대부분의 배경 타일은 더미(stand-in)입니다. <a href="images/readme/boards.mp4">고화질로 보기</a>를 참조하세요.</sub></p>
모든 터미널이 하나의 타일
- 각 타일마다 전체 터미널이 있어, Vim, 전체 화면 앱, 모든 에이전트가 탭에서 작동하는 것처럼 작동합니다. 제목 표시줄로 타일을 드래그하고 모서리에서 크기를 조정할 수 있습니다. 타일은 이웃과 일렬로 스냅됩니다 (스냅 방지하려면 ⌘를 누르세요).
- 패닝 및 확대/축소: 두 손가락으로 집거나(pinch), ⌘를 누른 채 스크롤하여 확대/축소할 수 있습니다. 빈 공간을 드래그하면 이동합니다. ⌥⌘9는 모든 것을 보여주고, ⌥⌘0은 실제 크기로 돌아갑니다. 제목 표시줄을 더블클릭하면 해당 타일로 즉시 이동합니다. 확대/축소는 터미널의 크기를 변경하지 않으므로 에이전트가 중단되지 않습니다.
- 전환 시 터미널 이동: 일반 창이 열려 있는 보드(Board)를 선택하면 Tellurion이 이를 이동할지 묻습니다. 모든 탭과 분할 화면은 프로젝트별로 그룹화된 타일이 되며, 에이전트는 계속 실행됩니다. **창 유지(Keep Windows)**는 현재 위치에 그대로 둡니다.
- 한 프로젝트의 타일들은 색상을 공유하며, 이름이 붙은 음영 영역이 있습니다. **프로젝트별 정리(Arrange by project)**를 사용하면 전체 보드가 깔끔하게 정리됩니다 (⌘Z를 누르면 원래대로 돌아갑니다).
- 가장자리 도구: 왼쪽에는 선택(Select), 에이전트(Agent), 그룹(Group), 터미널(Terminal), 텍스트(Text), 펜(Pen), 지우개(Eraser), 웹(Web), 이미지(Image)가 각각 하나의 키와 함께 있습니다. 오른쪽에는 레이어(Layers), 작업(Tasks), 파일 및 변경 사항(files and changes), 검토 루프(review loops)가 있습니다. 빈 보드를 마우스 오른쪽 버튼으로 클릭하면 빠른 동작 링이 나타납니다.
- 진행 상황 저장: 사용자가 보고 있던 타일과 창이 Tellurion 시작 시 복원되며, Claude Code와 Codex는 마지막 대화부터 이어서 진행됩니다. 사이드바의 보드(Boards) 목록은 보드 간을 전환하며, 떠난 보드는 계속 실행 상태를 유지합니다.
누가 당신을 필요로 하는지 확인하기
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-board.webp" alt="A board of twelve agent tiles in four colored project groups, zoomed out, with the agent list beside it and one agent waiting for permission" width="100%">
</p>
- 모든 타일의 가장자리는 에이전트의 상태를 보여줍니다: 에이전트가 작동하는 동안에는 숨 쉬는 듯한 움직임을 보이고, 사용자에게 도움이 필요할 때는 맥동합니다. 축소된 화면에서는 각 타일이 큰 글씨로 자신의 에이전트와 상태를 보여줍니다.
- 보드 옆 목록에는 사용자에게 도움이 필요한 에이전트가 가장 먼저 배치되며, 해당 행에 허용(Allow) 및 거부(Deny) 옵션이 있습니다. 행을 클릭하면 해당 타일로 이동합니다.
- 에이전트 이름: 에이전트 타일에는 짧은 이름(Ada, Otto, Cy 등)이 부여되어 구별하고 @멘션할 수 있습니다. 모든 제목 표시줄에는 재시작(Restart) 및 복제(Duplicate) 기능이 있습니다.
- 다른 곳에서도 마찬가지입니다: 알림, 메뉴 막대 항목, 휴대폰, 명령 팔레트 모두 보드 위의 에이전트를 포함합니다.
그룹 및 프리셋 (Groups and presets)
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-team.webp" alt="Ship 기능 프리셋에서 시작된 네 개의 에이전트: 새로운 그룹에 두 개의 Claude Code와 두 개의 Codex 타일" width="100%">
</p>
- 그룹 컴포저(Group composer) (바의 Group 칩): 이름, 역할, 최대 12개의 에이전트 슬롯, 폴더, 모든 에이전트를 위한 첫 번째 작업, 그리고 권한 프롬프트 건너뛰기(Skip permission prompts) 기능이 있습니다 (켜지 않으면 비활성화됨; 해당 타일에는 빨간색 No prompts 배지가 표시됩니다). **생성(Spawn)**을 통해 그리드 형태로 시작합니다.
- 프리셋(Presets): 설정을 저장하고, 몇 가지 기본 제공 프리셋이 있는 Presets 칩에서 다시 시작할 수 있습니다. **4개 생성(Spawn 4)**은 기본 에이전트 4개를 한 번의 클릭으로 시작합니다.
- 그룹은 역할(프론트엔드(Frontend), 백엔드(Backend), 테스터(Testers), 검토자(Reviewers), 디자인(Design), 문서화(Docs), 보안(Security), 일반(General))을 가지며, 각 역할은 색상으로 표시되고 현재 작동 중인 타일 수가 함께 표시됩니다. 그룹을 목록으로 접으면 에이전트는 계속 실행됩니다. 해당 헤더 메뉴를 통해 메시지 전송, 일시 정지, 정리 또는 전체 종료가 가능합니다.
- 그룹과 대화하기: 바에 **@**를 입력하고 그룹을 선택하여 해당 그룹의 모든 타일에 메시지를 보낼 수 있습니다.
오케스트레이터 (Orchestrator)
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-orchestrator.webp" alt="두 에이전트 그룹을 연결하는 오케스트레이터 카드와 그 그룹으로 이어지는 빛나는 와이어" width="100%">
</p>
사용자를 대신하여 에이전트 그룹을 실행하는 카드입니다.
- 연결하기 (Wire it up): Connect을 탭하고 터미널이나 그룹의 Click to wire group 알약을 클릭합니다. 빛나는 와이어는 연결된 것을 보여주며, 에이전트가 작동하는 동안 각 와이어를 따라 점이 움직입니다.
- 명령어 부여하기 (Give it a command): 사용자의 Claude Code(또는 Codex)가 작업을 분할하고, 각 에이전트에게 그 부분을 전송하며, 완료 시 답변을 읽고, 설정한 턴 제한까지 다음 단계를 전달합니다. @name은 특정 에이전트 하나로 바로 보내며, 새로운 에이전트를 시작할 수도 있습니다 ("두 명의 검토자 시작").
- 에이전트에게만 메시지를 보냅니다. 에이전트가 실행되고 있지 않은 와이어링된 터미널에는 절대 입력할 수 없으며, 권한 프롬프트는 여전히 사용자에게 표시됩니다.
미션 맵 (Mission Map)
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-mission-map.webp" alt="Mission Map: an orchestrator and the command bar on the left, a group in the middle, nine agents on the right with their status, and one agent selected" width="100%">
</p>
보드에서 누가 누구를 실행하는지: 오케스트레이터(orchestrators), 그들이 (또는 사용자가) 실행하는 그룹들, 그리고 모든 에이전트가 와이어로 연결되어 있습니다 (와이어가 점선인 경우 @을 통해서만 도달 가능한 에이전트). 상태별로 필터링(Working, Needs you, Idle, Done), 검색하고, 노드의 와이어를 따라 하버링하며, 아무거나 선택하여 해당 상태에 머문 시간을 확인하고, 그곳으로 이동하거나 일시 중지/정지할 수 있습니다.
보드 에이전트 (The board's agent)
모든 보드의 하단 바는 일반적인 요청(입력 또는 음성으로 말하기 - 스페이스바 길게 누르기)을 받습니다. 예: "kanban 카드당 Claude 에이전트 3개 시작", "백엔드 스케치: API, 큐, Postgres". 이는 에이전트와 터미널을 시작하고, 메모, 체크리스트, kanban 보드 및 다이어그램을 추가하며, 카드를 에이전트에게 전달하고, 타일을 그룹화하며, 요청한 내용으로 확대합니다.
자체 도구가 없으므로 사용자의 Claude Code(또는 Codex)를 실행하며, 따라서 보드를 배열하는 것만 할 수 있습니다. 타일 닫기, 이미 실행 중인 에이전트에 입력하기 및 확인을 기다리는 명령어 실행, 그리고 ⌘Z는 추가된 내용을 되돌립니다. ⌘L은 해당 위치로 이동합니다.
에이전트 맵 (Agent Map)
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-agent-map.webp" alt="프로젝트의 에이전트 맵: 폴더별로 그룹화된 파일 블록과 두 개의 에이전트 점, 그리고 그들이 방문한 파일의 흔적" width="80%">
</p>
보드는 코드 에디터 대신 에이전트 맵(Agent Map)을 갖습니다. 프로젝트 파일들은 폴더별로 그룹화된 지도 형태로 표시되며, 프로젝트에서 작업하는 모든 에이전트는 점으로 표현됩니다. 이 점은 읽거나 변경하는 파일로 이동하며, 지나온 파일의 흔적을 남깁니다. 수정된 파일은 일정 시간 동안 해당 색상으로 유지됩니다. 파일을 마우스 오버하면 누가 건드렸는지 알 수 있고, 에이전트를 클릭하면 해당 터미널로 이동할 수 있습니다. (단축키: ⌃⌘M) 또는 타일 메뉴에서 Show on Agent Map을 사용합니다.
웹 타일(Web tiles)
<p align="center">
<img src="https://raw.githubusercontent.com/steventsvik/Tellurion/HEAD/images/readme/board-web-tiles.webp" alt="로컬 상점 페이지를 보여주는 iPhone 14 Pro 크기로 배치된 웹 타일. 위쪽에는 해당 페이지가 나온 개발 서버 터미널이 있습니다." width="80%">
</p>
보드 위에 배치된 브라우저로, 페이지를 구축하는 에이전트 옆에 위치합니다. 탭, 뒤로 가기/앞으로 가기 버튼, 검색 기능도 하는 주소 표시줄, 현재 실행 중인 localhost 서버 목록을 보여주는 시작 페이지가 있습니다. 실제 화면(24", 27" 또는 32" 4K)이나 휴대폰(iPhone SE부터 Galaxy S8+까지) 크기로 설정하면 그 크기에 맞춰 페이지가 배치됩니다. **{}**를 누르면 Web Inspector가 열립니다. 웹 타일은 쿠키와 스토리지를 분리하여 유지하며, Tellurion 내부로 연결되는 브릿지가 없고 다운로드 요청을 거부합니다.
노트(Notes), 체크리스트 및 칸반(Kanban)
