mixpeek/amux

해결하는 문제

amux는 여러 AI 코딩 에이전트(예: Claude Code, Codex, Gemini CLI 및 Ollama)를 동시에 관리하기 위한 중앙 집중식 컨트롤 플레인을 제공합니다. 병렬 워커들의 "함대"를 조정하고, 작업 중복을 방지하며, 자율 에이전트 실행을 조종, 모니터링 및 스케줄링하기 위한 통합 인터페이스를 제공하는 문제를 해결합니다.

작동 방식

SQLite 백엔드를 사용하는 단일 Rust 바이너리로 구축된 amux는 에이전트 세션(일반적으로 tmux를 통해)을 관리하는 오케스트레이터 역할을 합니다. 작업을 조정하기 위해 일련의 핵심 프리미티브를 사용합니다:

• Board: 두 워커가 동일한 작업을 가져가지 않도록 보장하는 원자적 클레임 기능을 갖춘 공유 칸반 보드.
• Workers: 내구성 있는 ID를 가지고 있으며 피어 터미널을 들여다볼 수 있는 병렬 에이전트 세션.
• Schedules: 자율적인 야간 또는 주기적 실행을 위한 Cron 스타일의 반복 프롬프트.
• Groups & Scope: 메모리, 환경 변수 및 액세스 게이트를 공유하는 워커의 논리적 조직.
• .mdai Files: 방향성 비순환 그래프(DAG)를 형성하는 "계산된 마크다운 파일" 시스템. 이 파일들은 모델을 사용하여 다른 파일이나 폴더의 정보를 최종 출력으로 종합하며, 내장된 캐싱 및 순환 감지 기능을 갖추고 있습니다.
• Steering: 웹 대시보드 또는 모바일 앱을 통해 사용자는 메시지를 보내거나 실행 중인 세션을 실시간으로 리디렉션할 수 있습니다.

대상 사용자

여러 AI 코딩 에이전트를 병렬로 실행하며 개별적이고 연결되지 않은 세션을 관리하는 대신 팀으로 조정할 방법이 필요한 AI 엔지니어 및 개발자를 위해 설계되었습니다.

하이라이트

• 원자적 작업 관리: 에이전트가 공유 보드에서 작업을 클레임할 때 경쟁 상태를 방지합니다.
• 워커 간 통신: 에이전트 간의 출처 스탬프가 찍힌 메시징을 지원합니다.
• 로컬 우선 아키텍처: 자체 호스팅, SQLite 백엔드, 단일 Rust 바이너리로 배포.
• 동적 모델 전환: 컨텍스트 손실 없이 실행 중인 워커의 모델 또는 제공자를 교체할 수 있는 기능.
• 자가 치유: 충돌한 세션을 재시작하고 누락된 메시지를 재생하기 위한 와치독을 포함합니다.
• 계산된 마크다운 (DAG): .mdai 파일을 사용하여 복잡하고 다단계인 문서 및 연구 종합을 허용합니다.