duxweb/codux

⬛ A native connected terminal for AI agent development. 为 AI Agent 开发而生的原生互联终端。

Codux – 고성능 AI 코딩 터미널 (보관됨)

이것이 무엇인가

AI 기반 코딩 어시스턴트(예: OpenAI Codex, Claude Code, Kimi 등)를 사용하는 개발자를 위한 컨트롤 플레인 역할을 하는 네이티브 데스크톱(macOS, Windows, Linux) 및 모바일 앱입니다.
터미널, 프로젝트 인식 작업 공간, 토큰 사용량 분석, 자격 증명 격리 SSH/DB 헬퍼, 암호화된 피어 투 피어 링크를 번들로 제공하여 장기 실행 AI 에이전트 세션을 여러 기기와 헤드리스 호스트에서 유지할 수 있습니다.

핵심 아이디어

문제	Codux의 해결책
각 AI CLI가 자체 상태를 유지 → 작업 트리, 터미널, 토큰 간 혼란	모든 AI CLI, Git 작업 트리, 프로젝트별 터미널을 추적하는 통합 작업 공간
긴 에이전트 실행을 재개하기 어려움	실시간 상태, 로컬 기록, 세션 복원; 휴대폰이나 다른 컴퓨터에서 분리 및 재연결 가능
토큰 지출이 불투명함	도구, 모델, 프로젝트, 일별로 세분화된 실시간 토큰 사용량
자격 증명이 프롬프트에 노출됨	`codux-ssh` 및 `codux-db` 래퍼가 보호된 헬퍼 프로세스 내에서 비밀번호/키를 주입 – 모델이 이를 볼 수 없음
작업이 원격 머신에 있음	헤드리스 호스트(`codux-agent`)가 모든 서버/Mac/Linux 박스에서 실행; 데스크톱 또는 휴대폰이 종단 간 암호화된 P2P/릴레이 링크를 통해 연결

주요 기능

다중 도구 지원 – Codex, Claude Code, Oh My Pi, OpenCode, MiMo, Kiro, CodeWhale, Agy, Kimi 등용 래퍼.
작업 트리 우선 모델 – 각 Git 작업 트리에 자체 터미널, Git 상태, AI 세션이 제공됩니다.
토큰 분석 – 대시보드에서 모델/도구/프로젝트별 사용량을 보여줍니다.
자격 증명 격리 – codux-ssh / codux-db 명령을 통해 에이전트가 프롬프트나 셸 기록에 비밀번호를 노출하지 않고 서버/데이터베이스에 접근할 수 있습니다.
기기 무관 페어링 – 데스크톱, 휴대폰, 모든 헤드리스 호스트가 iroh 네트워킹 라이브러리를 통해 피어가 됩니다; 연결은 암호화되며 릴레이로 폴백할 수 있습니다.
웹 터널 브라우저 – 호스트를 통해 웹 트래픽을 프록시하는 내장 Chromium 뷰로, 원격 머신의 Vite 개발 서버를 로컬처럼 탐색할 수 있습니다.
터미널 펫 – 토큰 소비에 따라 레벨업하는 기발한 픽셀 펫(순전히 장식용).
로컬 우선 – 모든 데이터(프로젝트, 메모리, 자격 증명, 토큰 통계)는 사용자 머신에만 저장됩니다; 클라우드 서비스나 계정이 없습니다.

아키텍처(높은 수준)

데스크톱 앱 – Rust + GPUI로 작성, UI, 터미널 에뮬레이터, 지원되는 AI CLI에 환경 지시문을 주입하는 래퍼를 제공합니다.
모바일 앱 – 동일한 피어 네트워크에 연결되어 동일한 작업 공간을 표시하는 Flutter 프론트엔드.
헤드리스 호스트(codux-agent) – 모든 OS에서 실행되는 경량 Rust 바이너리로, 암호화된 링크를 통해 터미널, Git, AI 세션을 노출합니다.
네트워킹 – 종단 간 암호화된 P2P 연결을 위한 iroh 라이브러리 기반, 선택적 릴레이 폴백 지원.
자격 증명 헬퍼 – 저장된 프로필을 읽고 실제 연결을 수행하는 작은 하위 프로세스(codux-ssh, codux-db)로, AI 모델의 컨텍스트에서 비밀을 유지합니다.

설치

데스크톱 – macOS는 Homebrew Cask(brew install --cask duxweb/tap/codux) 또는 .dmg / Windows .exe 설치 프로그램 직접 다운로드.
Windows의 WSL – WSL을 활성화하고 Linux 배포판을 설치한 다음 앱 설정에서 Codux Runtime을 설치합니다.
모바일 – codux-flutter 릴리스의 Android APK; iOS 앱은 유료(Apple 개발자 비용을 충당)이지만 소스는 오픈소스입니다.
헤드리스 호스트 – 한 줄 스크립트 curl …/install.sh | sh(OS/아키텍처 자동 감지) 또는 수동 바이너리 다운로드.

라이선스 및 상태

GPL-3.0 라이선스.
저장소는 보관됨; 활발한 개발은 Sailry 프로젝트(sailry-harness)로 이동했습니다. 코드는 참조용으로 계속 사용할 수 있습니다.

누가 사용할 수 있나

위의 모든 정보는 README에서 직접 가져온 것입니다; 추가 기능은 추론되지 않았습니다.