simion/termic

새로운 기능이 출시될 때마다: 자체 Pro / Max 플랜에서 작동하는 실제 CLI, 공급업체 백엔드 불필요.

설치하기 · 작동 방식 · 샌드박스 · vs. Conductor · 기여하기

Termic은 AI 코딩 에이전트 CLI를 나란히 실행하는 무료 오픈 소스 데스크톱 앱입니다. 각 CLI는 자체 git worktree에 격리되며, 선택적으로 작업별 macOS 샌드박스 케이지가 제공됩니다. 이 앱은 실제 claude, codex, agy (Antigravity), copilot, 그리고 grok 바이너리(공급업체 SDK 아님)를 실행하므로, 추론 과정은 사용자가 이미 지불하고 있는 Pro / Max 플랜을 이용합니다. 같은 브랜치에 네 개의 에이전트를 띄우고 하나의 프롬프트를 모두에게 방송한 후, 신뢰할 수 있는 작업 완료 표시기를 보며 각 에이전트가 끝나는 순간을 확인할 수 있습니다.

권장 경로는 Homebrew와 공식 tap입니다:

brew install --cask simion/termic/termic

이 단일 명령은 simion/homebrew-termic를 자동 tap하고, 최신 .dmg 파일을 다운로드하며, Termic.app을 /Applications에 설치합니다. Termic은 Developer ID 인증서로 서명되었고 Apple의 공증(notarized)을 거쳤기 때문에 Gatekeeper 경고가 없습니다.

업데이트: Termic은 자체 업데이트 기능을 제공합니다. 새 릴리스가 나오면 툴바 오른쪽 상단에 Update X.Y.Z 배지가 표시됩니다. 이를 클릭하여 다운로드 + 검증 + 재실행할 수 있습니다. 수동으로 확인하려면:

brew upgrade --cask termic

.dmg, .app.tar.gz, 그리고 각 버전의 ed25519 서명은 Releases 페이지에서 확인할 수 있습니다. .dmg 파일은 Apple에 의해 서명 및 공증되었으므로, 처음 실행해도 다른 작업 없이 열립니다.

Releases 페이지에서 termic_<version>_amd64.AppImage를 다운로드하여 실행 가능하게 만든 후 실행합니다:

chmod +x termic_*_amd64.AppImage
./termic_*_amd64.AppImage

이 AppImage는 macOS 빌드와 동일한 CI 흐름으로 ed25519 서명되었기 때문에, 인앱 업데이트기도 동일하게 작동합니다: 새 릴리스가 오른쪽 상단의 Update X.Y.Z 배지로 나타나고, 클릭하여 다운로드 + 검증 + 재실행할 수 있습니다. AppImage는 ~/Applications/와 같이 쓸 수 있는 위치에 보관하여 업데이트기가 제자리에 대체할 수 있도록 합니다.

Seatbelt 샌드박스는 macOS 전용이므로, Linux에서는 작업의 Shield 토글이 비활성화됩니다. Docker 모드가 Linux의 해결책입니다: macOS에 국한되지 않으므로, Docker가 실행되는 곳이라면 어디든 컨테이너 안에 에이전트를 가둘 수 있습니다. 그 외 모든 것(worktrees, 병렬 탭, find-in-files, 테마, 인앱 diff)은 동일하게 작동합니다.

Wayland 참고: 글꼴이 얇게 렌더링되면, 실행 명령어 앞에 GDK_BACKEND=x11을 사용하여 X11로 강제 지정하세요 (또는 .desktop 파일의 Exec=에 사용).

git clone https://github.com/simion/termic
cd termic
make setup # brew/rust/node + npm install + cargo check
...

make dev (vite HMR + Rust 자동 재빌드)가 반복 개발 루프입니다. 코드를 수정할 계획이라면 CONTRIBUTING.md를 참조하세요.

릴리스 페이지의 서명된 AppImage가 대부분의 사용자에게 권장되는 경로입니다 — 위 Linux (AppImage) 섹션을 참고하세요. 직접 수정하고 싶다면 소스에서 빌드하여, 자신만의 배포판 패키징을 위해 .deb / .rpm 파일을 배포하거나 미출시 커밋을 실행하세요.

사전 요구 사항 — Debian / Ubuntu (24.04+는 WebKitGTK 4.1 포함):

sudo apt update
sudo apt install -y \
build-essential curl wget file git pkg-config \
...

Fedora:

sudo dnf install -y \
@development-tools curl wget file git pkgconfig \
webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel \
...

Arch:

sudo pacman -S --needed base-devel curl wget file git pkgconf \
webkit2gtk-4.1 gtk3 libayatana-appindicator librsvg openssl libsoup3 xdotool

빌드 및 설치:

git clone https://github.com/simion/termic
cd termic
npm install
...

번들 파일은 src-tauri/target/release/bundle/ 아래에 위치합니다. 배포판에 맞는 것을 선택하세요:

# Debian / Ubuntu / Pop / Mint
sudo apt install ./src-tauri/target/release/bundle/deb/termic_*_amd64.deb
# Fedora / RHEL / openSUSE
...

.deb / .rpm 설치 후,

만약 창이 약간 어색하게 보인다면 — 예를 들어, 상단 바 왼쪽에 빈 공간이 있다면 — 그것은 macOS의 트래픽 라이트(traffic-light) 컨트롤을 위한 84px 예약 공간입니다. 무해하며, 크로스 플랫폼 chrome이 출시되면 정리될 것입니다.

Wayland 참고: 글꼴이 가늘게 렌더링된다면 GDK_BACKEND=x11 termic으로 X11을 강제하세요

(또는 .desktop 파일의 Exec=에 설정합니다).

각 릴리스에는 Windows 11 x64 설치 프로그램인 Termic_<version>_x64-setup.exe가 Releases 페이지에 포함되어 있습니다. 이 프로그램은 사용자별로 설치되며 (관리자 권한 불필요), macOS 및 Linux 빌드처럼 자체 업데이트됩니다. 아직 코드 서명(code-signed)되지 않았기 때문에 SmartScreen이 먼저 묻습니다: 자세히 알아보기, 그래도 실행하기. Windows 지원은 새로 추가된 것이라 아직 일상적으로 사용되지는 않습니다. Docker 모드는 Windows의 샌드박스이며, macOS의 Seatbelt 샌드박스는 여기에 존재하지 않습니다.

직접 빌드하려면 Git Bash(Git for Windows에 포함됨)에서 다음을 수행하세요:

git clone https://github.com/simion/termic
cd termic
bash scripts/setup-windows.sh # winget을 통해 빌드 도구, Rust, Node, make를 설치하고; npm install; cargo check
...

설정 세부 정보, macOS와 다른 점, 그리고 Windows에서 아직 지원되지 않는 기능은 docs/windows.md를 참조하세요.

전체 개발 가이드는 CONTRIBUTING.md를 참고하세요.

모든 에이전트는 실제 PTY(Pseudo Terminal) 내부에서 실행되며, iTerm에서 실행할 것과 동일한 바이너리를 사용하므로 사용자님과 CLI 사이에 아무것도 없습니다. 별도의 크레딧 풀로 비용을 청구하는 벤더 SDK도 없고 (2026년 6월 기준), 측정된 마크업(metered markup)도, 백엔드 데몬도 없습니다. 상단 창이 제공하는 기능은 다음과 같습니다:

병렬 작업 트리(Parallel worktrees). 각 작업은 ~/termic/tasks/<project>/<name>/ 아래의 git worktree입니다.

N개의 에이전트를 동일한 브랜치에 대해 여러 탭에서 실행합니다. 작업 트리를 원하지 않으면 리포지토리 루트에 연결하고, 같은 최신 커밋(tip)을 기반으로 병렬 시도를 시작하려면 작업 트리를 복제하세요.**명령 팔레트 (⌘K).**새로운 태스크, 파일 선택기, 파일 내 검색, 이름 변경, 아카이브, YOLO, 샌드박스, 테마, 사이드바, 설정 등 모든 액션을 한 곳에서 검색하고 실행할 수 있으며, 각 항목에는 인라인 단축키가 있습니다. ⌘N은 빠른 프로젝트 선택기로, 사이드바를 건드리지 않고도 임의의 리포지토리를 퍼지(fuzzy-find)로 찾아 태스크를 시작할 수 있게 합니다.멀티 리포지토리 태스크. 여러 저장소(백엔드, 프론트엔드, 인프라)를 하나의 태스크 아래에 그룹화하고 공유되는 CLAUDE.md 파일과 각 멤버별 dev-server 포트를 설정합니다. 파일 찾기, 파일 내 검색, 그리고 diff 뷰가 모든 멤버에게 적용됩니다.브로드캐스트 및 브레인스토밍. 단일 프롬프트를 태스크의 모든 에이전트에게 동시에 전송할 수 있습니다(⇧⌘B). 다중 에이전트 코드 리뷰, 아키텍처 브레인스토밍 또는 복잡한 버그에 대한 네 명의 '두 번째 의견'을 몇 초 만에 얻는 데 완벽합니다.**코드로서의 설정(**프로젝트별 모든 설정을—설정 스크립트, 실행 명령어, 미리보기 URL 및 샌드박스 허용 목록—.termic.yaml 파일에 저장합니다). 이 파일을 리포지토리에 커밋하여 팀 전체가 즉시 동일한 최적화된 에이전트 환경을 갖도록 합니다.태스크별 샌드박스(macOS). sandbox-exec를 통한 파일 시스템 및 네트워크 격리(cage)와 호스트 이름 허용 목록이 있는 인프로세스 HTTPS CONNECT 프록시를 제공합니다. --dangerously-skip-permissions 옵션으로 에이전트가 실행되도록 할 수 있습니다.

safely — 케이지는 프롬프트가 아니라 경계입니다. 아니면 컨테이너 안에 가두세요: Docker 모드는 더 강력한 파일 시스템 경계를 가진 대안적인 격리 백엔드입니다 (실험적; 네트워크 이그레스 제한 방식이 프록시가 안전벨트를 제한하는 방식과는 다릅니다). 사이드바 코크핏(Sidebar Cockpit). 사이드바에서 작업을 확장하여 활성화된 모든 에이전트, 그들의 실시간 작업 완료 지표, 그리고 그들이 관리하는 제목을 한눈에 볼 수 있습니다. 실제로 신뢰할 수 있는 작업 완료 지표입니다. Per-CLI 제목 분류기(Claude 스피너 등)와 OSC 9;4를 사용하며, 바이트 무음 및 콘텐츠 해시 검사를 통해 게이팅됩니다. 이 신뢰성 덕분에 에이전트가 실제로 턴을 마쳤을 때만 작동하는 선택적 데스크톱 알림이 가능해졌습니다. 메시지 큐(Message Queues). 작업 완료 감지를 기반으로 구축되었으며, N개의 메시지(선택적 반복 포함)를 큐에 넣어 자율적인 'Ralph 루프' 세션을 실행합니다. 모든 것 자동 재개(Auto-Resume Everything). Termic은 리포지토리 루트 작업의 경우에도 세션을 자동으로 재개하며, 주요 작업뿐만 아니라 작업 내의 모든 에이전트 탭을 재개합니다. 스팟라이트(Spotlight). 하나의 워크트리의 변경 사항—커밋된 것, 커밋되지 않은 것, 추적되지 않은 것—을 실시간으로 리포지토리 루트에 미러링하여 편집기, 개발 서버, 브라우저가 에이전트의 작업을 라이브로 볼 수 있게 합니다. 이는 분리된 HEAD에서 실행되며 브랜치에 절대 커밋하지 않습니다. 비활성화하면 체크아웃이 깨끗하게 복원됩니다. (Conductor는 브랜치를 체크포인트합니다. Spotlight는 건드리지 않습니다.) 인앱 검색 및 편집(Find + edit in-app). ⌘P 퍼지 파일 찾기, ⇧⌘F 파일 내 검색(ripgrep 사용 시)에 git grep을 사용할 수 있습니다.

그 외에도, .gitignore를 인식하고 스트림을 실시간으로 보여줍니다). CodeMirror 6 에디터는 나란히/통합된 diff를 제공하며, 약 150개 언어에 대한 하이라이팅, 인라인 git blame, 재시작해도 유지되는 스크래치패드 탭, 그리고 Markdown 미리보기(인라인 Mermaid 다이어그램 포함) 기능을 갖추고 있습니다.코드 탐색( #174). 정의로 이동하려면 ⌘-클릭 또는 F12를 누르고, 사용처는 ⇧F12를, 파일 개요는 ⌘F12를 사용하며, 호버링 시 타입을 확인하고, double-⇧를 눌러 리포지토리 전체의 심볼을 검색할 수 있습니다. 자체 툴체인(TypeScript, Python, Rust, Go, C/C++, Swift, Ruby)의 실제 언어 서버가 각 체크아웃마다 제공되며, 프로젝트에 대해 활성화하고 그 비용에 동의하기 전까지는 아무것도 실행되지 않습니다. 언어나 프로젝트별로 다른 서버를 선택하거나 자체 바이너리를 지정할 수 있습니다. 타입 검사는 별도의 실험적 스위치입니다.Fork 스타일 Git UI. Fork 앱에서 영감을 받은 전용 스테이징 영역: 터미널로 내려가지 않고도 스테이징, 언스테이징 및 커밋을 할 수 있습니다. 또한 History 기능은 레인(lanes), ref 칩, 그리고 git이 실행하는 메시지 검색을 갖춘 전체 커밋 그래프를 제공하며 (10페이지 전의 일치 항목이라도 가장 먼저 표시됨), Compare 기능은 어떤 ref와 작업 트리 간에 다른 모든 경로를 하나의 트리에 보여주며, '본 내용으로 표시' 및 인라인 댓글 기능이 여전히 활성화되어 있습니다.풀 리퀘스트(Pull requests). 작업에서 GitHub PR, GitLab MR 또는 Azure DevOps PR을 열고 오른쪽 패널에서 확인합니다: 체크, 검토 상태, 그리고 해당 작업 트리에서 작업하는 에이전트에게 전달되는 댓글들입니다. 또는 이슈나 Azure Boards 작업 항목으로부터 작업을 시작하고, 작성된 프롬프트가 첫 메시지 상자에 드롭되어 전송되기 전에 읽어볼 수 있습니다. 자체 호스팅 GitHub Enterprise와 GitLab도 작동하며; Azure DevOps는 az와 azure-devops를 필요로 합니다.

확장 기능(cloud 전용, Server 불가). 세 가지 모두 공식 CLI의 로그인 기능을 사용합니다.에이전트 레이스(Agent races). 하나의 프롬프트를 여러 에이전트에게 동시에 보내고, 각 에이전트는 독립적인 새 작업 트리에서 작업을 수행하게 한 다음, 완료되면 그들의 차이점(diffs)을 N-up으로 비교하고 승리한 결과를 메인 체크아웃에 적용합니다.인라인 검토 댓글(Inline review comments). diff 또는 읽고 있는 모든 파일에 GitHub 스타일의 인라인 댓글을 남길 수 있습니다. 이 댓글들은 한 메시지로 묶여 전송 시 에이전트에게 전달됩니다. 프롬프트 라이브러리의 '검토(Review)' 프롬프트는 반대 방향으로 작동합니다: 에이전트에게 diff를 넘겨주고 검토하도록 할 수 있습니다.프롬프트 라이브러리(Prompt library). 재사용 가능한 프롬프트를 저장하고, 상단 메뉴에서 실행 중인 또는 새로운 에이전트에게 전송할 수 있습니다. '검토(Review)', '테스트 작성(Write tests)', '보안 검토(Security review)', '변경 사항 설명(Explain changes)', '커밋(Commit)' 기능이 기본으로 제공되며, 에이전트가 바쁠 경우 자동으로 대기열에 추가됩니다.자체 에이전트 연결(Bring your own agent). 설정 → 에이전트(Settings → Agents)는 편집 가능한 레지스트리입니다. aider, ollama, 셸 스크립트를 드롭하기만 하면 30초 만에 완료됩니다. Claude, Codex, Antigravity, Copilot, Grok, opencode, pi, Muse Code, Devin이 기본 내장 기능으로 제공됩니다.키보드 우선(Keyboard-first). ⌘K 명령 팔레트, ⌘1..9로 탭 전환, ⌥↑/↓로 보이는 사이드바 트리를 탐색, ⌥⌘↑/↓로 작업 전용 항목 이동, ⌘D / ⇧⌘D로 오른쪽 / 아래쪽 분할, ⌘T로 새 탭 생성, ⌘W로 탭 닫기. 모든 단축키는 설정 → 단축키(Settings → Shortcuts)에서 재지정 가능합니다 (⌘/를 검색 가능한 치트 시트로 사용). 일곱 가지 테마(System, Light, Claude, Dark+, Solarized Dark, Cobalt, Matrix)가 있으며, 각각 크롬과 터미널 창을 모두 리테마링할 수 있습니다. 또는 자체 테마를 가져올 수도 있습니다: JSON 파일을 테마 폴더에 드롭하면 선택기에서 일급 테마로 나타납니다 — 자세한 내용은 docs/themes.md를 참조하세요.칸반 보드(Kanban board). 대시보드와 히스토리 옆의 세 번째 탐색 뷰입니다. 모든 작업은 터미널이 실제로 수행하는 작업(시작 안 함, 진행 중, 사용자 필요, 검토 중, 완료)을 기반으로 한 열의 카드입니다. 누군가 끌어다 놓는 상태가 아닙니다. 여러 에이전트가 카드를 가질 경우 에이전트별로 수영 레인(Swimlanes)이 생성되며, '보관됨(Archived)'에 드롭하면 일반적인 확인 절차를 거쳐 보관되고, '검토 중(In review)'에 드롭하면 PR을 엽니다.

의미가 없는 것은 되돌아갑니다.당신의 언어로 말합니다. 전체 인터페이스는 번역되며, 완전한 중국어 간체(Simplified Chinese) 로케일이 1.10.0에 포함되었습니다. 설정 → 일반 → 언어에서 시스템, 영어 또는 중국어 간체를 선택할 수 있으며, 재시작 없이 스위치가 즉시 적용됩니다.외부에서 구동합니다.termic