터미널을 앱이 아니라 백그라운드 데몬이 들고 있게 해서, 창을 닫거나 앱이 죽거나 업데이트해도 에이전트가 계속 돈다. 그 위에 “어느 에이전트가 나를 기다리나”를 사이드바·탭·메뉴 막대에 표시하고, worktree·Git·사용량 한도를 한 창에 모았다. 아직 별 4개짜리 1인 프로젝트라 기능 설명은 README·가이드 기준이다.

개요

anilsenay가 만든 macOS 앱이다. MIT 라이선스이고 macOS 14 이상, Apple Silicon과 Intel을 지원한다. 2026-11-04에 저장소가 생겼고 일주일 만에 v0.5.1(2026-11-11)까지 나왔다. 2026-11-16 수집 기준 ★4, 포크 0, 기여자는 작성자 1명(커밋 417)이다. 서명·공증된 DMG나 Homebrew(brew install --cask anilsenay/tap/octomux)로 설치하고, 새 버전은 앱 안에서 Sparkle로 업데이트한다.

비슷한 자리의 도구로 2026-08-05-github-muxy-app-muxy(같은 SwiftUI·libghostty 조합), 터미널 안 멀티플렉서인 2026-08-02-herdr-agent-multiplexer, worktree 병렬 관리 앱 2026-10-05-news-hada-34783-offrun이 있다. Octomux가 앞세우는 차이는 세션 지속성이다.

구조

Octomux.app (Swift, AppKit + SwiftUI)
  ├─ 각 pane = 세션에 붙은 libghostty 화면
  └─ 제어 연결 ──▶ octomux 데몬 (Rust, launchd agent)
                     ├─ SQLite 카탈로그: 워크스페이스·프로젝트·탭·세션·에이전트·설정
                     ├─ 에이전트 hook → 상태·알림·사용량
                     └─ 세션마다 `octomux holder` 1개 (PTY + 헤드리스 터미널 상태)

세션마다 holder 프로세스가 PTY를 따로 쥐고 있어서 앱 종료, 데몬 재시작, 업데이트를 견딘다. 재부팅 뒤에는 Claude Code와 codex 세션만 --resume·codex resume으로 같은 대화를 잇는다. 일반 터미널은 새 셸로 돌아온다. Electron이 아니라 AppKit과 GPU 렌더링(libghostty)이다.

에이전트별 지원 범위

어떤 CLI 에이전트든 그냥 터미널로 돈다. 상태 표시·재개·한도는 두 에이전트만 된다.

에이전트앱 종료 후 유지작업 중/입력 대기 표시재부팅 후 재개사용량 한도채팅 뷰
Claude Code✓✓✓✓✓
Codex✓✓ (0.164+)✓✓✓
Gemini, Amp, OpenCode, Cursor, Kiro, Antigravity, Copilot 등✓————

상태를 아는 방식이 에이전트마다 다르다.

  • Claude Code: Octomux가 hook과 status line을 --settings 플래그로 주입한다. ~/.claude/settings.json은 건드리지 않는다. status line 명령(octomux statusline)은 5시간·주간 한도를 최대 15초마다 데몬에 보낸 뒤 사용자가 원래 쓰던 statusLine 명령을 같은 입력으로 실행한다. 그래서 기존 status line은 그대로 보인다.
  • Codex: 설정할 것이 없다. 0.164부터 Codex가 자기 상태(작업 중·승인 대기·완료)를 터미널에 알리고, Octomux가 그걸 읽는다. 한도는 rollout 파일에서 읽는다.

에이전트를 감싸지 않는다는 점을 강조한다. 사용자의 CLI를 사용자 설정·로그인 그대로 실행하고, Octomux는 터미널만 소유한다.

주요 기능

기능내용
대기 알림에이전트가 끝나거나 입력을 기다리면 macOS 알림, 클릭하면 그 pane으로 이동. ⌘⇧U는 다음 대기 세션으로 점프. 메뉴 막대 아이콘에 입력 대기 시 주황 점(0.5.1)
Git worktree프로젝트 우클릭 → New Worktree로 <부모>/<repo>.worktrees/<branch>에 브랜치를 만들고 에이전트를 연다. 생성 직후 setup 스크립트(의존성 설치, .env 복사), 삭제 전 teardown 스크립트
오른쪽 패널포커스된 세션 폴더의 파일 트리·코드 뷰어, 변경 파일 diff, commit & push, 커밋 히스토리. 커밋 메시지·PR 본문은 에이전트(Claude는 기본 Haiku)가 초안 작성
채팅 뷰⌘⇧C로 Claude·Codex 세션을 도구 호출 카드가 있는 채팅으로 보기. 입력은 같은 세션으로 들어가고, 권한 프롬프트는 터미널에서 답한다
원격 호스트Linux 서버에 octomux 바이너리를 올리고 SSH로 연결하면 서버 세션이 로컬 세션 옆에 뜬다. 연결을 끊어도 세션 유지. docker exec -i <container> 같은 커스텀 명령 호스트도 가능
MCP 목록Claude Code의 .claude.json·프로젝트 .mcp.json, Codex config.toml에서 MCP 서버를 읽어 보여 주고 claude mcp list로 연결 확인
유휴 정리”Stop idle agents”(기본 꺼짐)는 턴을 끝내고 정해진 시간 동안 출력이 없는 에이전트를 멈춘다. Resume으로 대화 재개
꾸미기테마 프리셋, 반투명 터미널 뒤 20종 넘는 픽셀아트 애니메이션 배경, ⌘K 명령 팔레트, 단축키 재지정

v0.5.0(2026-11-08)에서 레이아웃이 셋으로 늘었다. Terminal(기존 창), Agents(필요한 것 기준으로 묶은 에이전트 레일 + Home), Tasks(작업 레일 + 워크스페이스 어시스턴트가 요청을 작업으로 쪼개 에이전트를 띄움)다. Home은 섹션을 끌어 배치하는 페이지로, 모든 에이전트를 픽셀 문어로 보여 주는 Aquarium 프리셋도 있다. 레이아웃은 .octomux-layout.json 파일로 내보내고 가져올 수 있다. 에이전트용 내장 브라우저도 이때 들어왔다. 긴 페이지는 전문 대신 개요(랜드마크·제목·링크·필드)를 돌려줘 토큰을 약 4분의 1로 줄인다고 한다.

개인정보

로컬 우선이다. 계정, 분석, 텔레메트리가 없다. 데이터는 ~/Library/Application Support/Octomux/의 SQLite에 있다. 앱이 직접 인터넷에 나가는 것은 업데이트 피드 확인과 URL로 배경 장면을 가져올 때뿐이라고 README에 적혀 있다. 진단 zip은 토큰·키·비밀번호·이메일을 지우고 만든다.

알려진 한계

  • 세션에 다시 붙을 때 재생하는 스크롤백은 세션당 3000줄까지다.
  • 알림은 앱이 띄운다. 앱을 완전히 끄면 세션은 돌지만 알림은 오지 않는다.
  • 재부팅 뒤 재개는 Claude Code·Codex만 된다.
  • 원격 호스트용 Linux 바이너리는 배포본이 없어 직접 빌드(tools/build-linux.sh, zig 필요)해야 한다.
  • 생긴 지 2주가 안 됐고 사용자가 거의 없다. 변경 로그를 보면 0.5.x에서도 CPU 과다 사용(작업 표시 애니메이션이 창 전체를 매 프레임 다시 그림), 브라우저 호출 취소 시 앱 종료 같은 버그를 고치는 중이다.

관련 노트