LumaryLabsLLC/muxin

All your machines, one app. For you and your AI agents: agent sessions, desktops, files, logs and GitHub across your Macs, Linux and Windows machines, with an MCP server.

Muxin이란 무엇인가요?

Muxin은 Mac, Linux, Windows PC 등 자신이 소유한 컴퓨터 군을 관리하고, AI 기반 에이전트(Claude Code, Codex, Gemini CLI 등)가 해당 머신을 작업 공간으로 사용할 수 있게 해주는 네이티브 데스크톱 애플리케이션입니다. 다음과 같은 기능을 위한 그래픽 허브를 제공합니다:

SSH 기반 머신 인벤토리 – ssh 또는 Tailscale을 통해 접근 가능한 모든 머신을 검색, 추가 및 모니터링합니다.
실시간 데스크톱 공유 – 앱 내에서 원격 머신의 화면을 보고 상호작용합니다.
파일/클립보드 동기화 – OS에 관계없이 머신 간에 파일/폴더를 복사합니다.
자체 호스팅 GitHub 러너 관리 – 모든 머신에서 GitHub Actions 러너를 설치, 시작, 중지 및 모니터링합니다.
에이전트 세션 – LLM 기반 "에이전트"(Claude Code, Codex, Gemini 등)를 실행하는 터미널을 모든 머신에서 시작합니다. UI를 닫아도 세션은 유지됩니다.
작업 공간(Workspaces) – 에이전트가 코드를 편집하고 실행할 수 있는 머신 내의 영구 폴더(git 체크아웃 가능).
상태 모니터링 – CPU, 메모리, 디스크, 가동 시간 및 머신 오프라인 시 자연어 상태 표시.

이 모든 기능은 AI 에이전트가 프로그래밍 방식으로 호출할 수 있는 Model Context Protocol (MCP) 서버 (muxin mcp)를 통해서도 노출됩니다.

누가 사용하면 좋을까요?

개인용 머신 군을 보유한 개발자 – Mac Studio, NUC, 노트북, 클라우드 VM 등 어디서 무엇이 실행 중인지 단일 UI로 확인하고 싶은 분.
자체 호스팅 GitHub Actions를 운영하는 팀 – 모든 머신에서 러너를 빠르게 설치하고 관리하고 싶은 분.
AI 에이전트 파워 유저 – Claude Code, Codex, Gemini 등이 선택한 머신에서 직접 작업하고, 파일을 편집하고, 빌드를 실행하고, 결과를 보고하게 하고 싶은 분.
시스템 관리자 – 상태 모니터링, Wake-on-LAN을 통한 머신 깨우기, 여러 호스트에 걸친 명령 실행이 필요한 분.

작동 원리

검색 – Muxin은 ~/.ssh/config, Tailscale 및 로컬 네트워크 브로드캐스트(Bonjour)를 읽어 머신을 제안합니다.
연결 – 기존 키/에이전트를 사용하여 각 호스트에 SSH로 연결합니다. 연결되면 MCP 프로토콜을 사용하는 소형 Muxin agent(Rust로 작성됨)를 배포합니다.
UI 레이어 – 데스크톱 UI는 GPU 가속 Rust UI 프레임워크인 GPUI(Zed 에디터와 동일)로 구축되었습니다. macOS, Linux, Windows에서 네이티브로 실행됩니다.
MCP 서버 – muxin mcp가 로컬에서 실행되며 JSON 인코딩된 명령을 원격 에이전트로 전달합니다. LLM 기반 에이전트는 이러한 도구를 호출하도록 구성되어 "에이전트 우선" 기능을 제공합니다.
상태 – 모든 설정은 ~/.config/muxin/(Windows의 경우 %APPDATA%\muxin\) 아래의 단일 config.toml에 저장됩니다. 런타임 상태(마지막 확인 타임스탬프, 직접 연결 정보 등)는 함께 제공되는 JSON 파일에 저장됩니다.

무엇을 할 수 있나요?

기능	사용 사례
에이전트 세션	원격 Mac에서 Claude Code 터미널을 열어 빌드 오류를 수정하고, UI를 닫은 후에도 세션을 유지합니다.
데스크톱 공유	주 워크스테이션을 떠나지 않고 Linux 박스의 GUI를 확인하여 UI 버그를 해결합니다.
파일 동기화	Mac에서 Windows VM 사이드바로 폴더를 드래그하여 즉시 복사합니다.
러너 관리	NUC에 두 개의 GitHub Actions 러너를 설치하고 시작하여 개요 페이지에서 작업 대기열을 확인합니다.
상태 대시보드	모든 머신의 CPU % 및 디스크 사용량을 한눈에 확인하고, 경고를 클릭하여 Linux 호스트를 자동으로 재부팅합니다.
전체 머신 명령 실행	모든 macOS 머신에서 `brew upgrade`를 실행하고 결과를 나란히 확인합니다.
작업 공간	원격 머신에 리포지토리를 체크아웃하는 작업 공간을 생성하여 AI 에이전트가 코드를 편집, 테스트 실행 및 변경 사항을 푸시하게 합니다.
MCP 도구	스크립트에서: `muxin mcp run_on_machines "git pull" --machines mac-studio,raspberry-pi`를 실행하여 모든 곳의 리포지토리를 업데이트합니다.
Wake-on-LAN	빌드 시작 전 UI에서 Wake를 눌러 절전 모드인 데스크톱을 켭니다.

시작하기

다운로드 – 최신 GitHub 릴리스에서 적절한 설치 프로그램(DMG, .deb/.rpm/AppImage 또는 Windows .exe)을 받으세요. Homebrew도 지원됩니다.
실행 – 앱을 실행하면 현재 컴퓨터가 자동으로 config.toml에 추가됩니다.
머신 추가 – ⌘N(또는 Add Machine 버튼)을 누르고 제안(SSH 설정, Tailscale, Bonjour) 중에서 선택하세요.
탐색 – ⌘T로 에이전트 세션을 열고, ⌘6으로 여러 호스트에서 명령을 실행하거나, Jobs 뷰에서 GitHub 러너 활동을 확인하세요.
AI 에이전트 활성화 – "Use it from AI agents" 섹션에 따라 Claude Code, Codex 또는 MCP 호환 클라이언트를 muxin mcp에 연결하세요.

제한 사항

SSH 접근 필요 – 머신은 SSH(또는 Tailscale)를 통해 접근 가능해야 하며 소형 Muxin agent를 설치할 수 있어야 합니다.
자체 호스팅 전용 – 사용자가 소유한 머신을 관리하며, 클라우드 인스턴스를 프로비저닝하지 않습니다.
GUI 중심 – CLI(muxin …)가 존재하지만, 대부분의 일상적인 상호작용은 그래픽 UI를 통해 이루어집니다.
에이전트 지원 – 내장 도구는 MCP 프로토콜을 이해하는 에이전트(Claude Code, Codex, Gemini CLI 등)를 가정합니다. 다른 에이전트는 사용자 지정 MCP 클라이언트 코드가 필요합니다.

제작자

Muxin은 Lumary Labs LLC의 오픈 소스 프로젝트이며 Apache-2.0 라이선스로 릴리스되었습니다. Rust로 개발되었으며 GPUI UI 프레임워크를 활용합니다.

빠른 참조(명령어)

# 데모 모드 – 실제 머신에 영향을 주지 않음
muxin --demo

# 머신 추가 (SSH 호스트)
muxin add-machine --name "Mac Studio" --host ci@mac-studio.local

# 여러 머신에서 명령 실행
muxin run_on_machines "df -h /" --machines mac-studio,raspberry-pi

# MCP 서버 시작 (AI 에이전트용)
muxin mcp

결론

Muxin은 개인 하드웨어와 최신 LLM 에이전트를 연결하는 네이티브 크로스 플랫폼 플릿 매니저로, 상태 확인, 명령 실행, GitHub 러너 관리 및 AI 에이전트의 머신 제어를 한곳에서 수행할 수 있게 해줍니다.