빠른 시작 · 첫 실행 · 일상 사용 · 프로덕션 설치 · 이슈

Gajae App이 하는 일

Gajae App은 **내 머신/서버의 tmux에서 이미 돌고 있는 코딩 에이전트들을 들여다보는 단일 사용자 관제창**이다. 세션을 자동으로 발견하고, 브라우저나 폰에서 다음을 할 수 있다:

• 뭐가 돌고 있는지 본다 — 지원 에이전트가 든 tmux 세션이 등록 절차 없이 사이드바에 자동으로 뜬다. 턴이 진행 중인 세션은 RUN(초록), 지시 대기는 LIVE(파랑), 첫 대화 전 pane은 대기로 구분된다.
• 대화를 실시간으로 본다 — Gajae Code(GJC) 세션은 transcript 기반 실시간 채팅 뷰로, Claude Code·Codex 세션은 attach된 터미널로 열린다.
• 세션을 찔러준다 — 라이브 GJC 세션에 메시지를 보내고, 새로 띄우고, 죽인다. 갓 띄워 첫 대화 전인 세션에도 사이드바에서 바로 첫 메시지를 보낼 수 있다. 다른 에이전트는 attach된 터미널에 직접 타이핑한다.
• 알림을 받는다 — 라이브 턴이 끝나면 탭을 다 닫아도 web push가 온다.
• 히스토리를 뒤진다 — 과거 프로바이더 세션이 네이티브 세션 스토어에서 자동 인덱싱된다.

세션의 주인은 tmux다: Gajae App을 재시작하거나 꺼도 세션은 죽지 않는다.

웹에서 에이전트를 직접 실행하는 것도 가능하다(스트리밍 채팅 + 툴 콜 승인, 파일 브라우저/에디터, 스킬, MCP 설정) — 관제창 위의 보조 레인이다. 확정된 v1/v2 스코프 기준선은 [docs/MVP.md](docs/MVP.md)에 있다.

앱에 모델 구독은 포함되지 않는다. 사용할 에이전트 CLI는 Gajae App을 돌리는 호스트의 같은 OS 사용자로 미리 설치·인증해 둬야 한다.

지원 에이전트

• Gajae Code (GJC) — 라이브 채팅 뷰, 메시지 릴레이, spawn/kill + 웹 구동 채팅
• Claude Code — tmux 터미널 attach + 웹 구동 채팅
• Codex — tmux 터미널 attach + 웹 구동 채팅
• Cursor — 웹 구동 채팅
• OpenCode — 웹 구동 채팅

프로바이더별 모델·effort·권한 모드·세션 히스토리·스킬·MCP 기능은 해당 프로바이더가 지원할 때만 노출된다.

빠른 시작

**일상 사용이 목적이면 [프로덕션 설치](docs/INSTALL.md)를 따라 릴리스 아티팩트로 설치하라.** 아래 소스 실행은 코드를 고치는 개발용이다 — 미리 빌드된 번들 없이 즉석 변환으로 돌기 때문에 로딩이 느리고, HTTP라 브라우저의 앱 설치(PWA)도 제한된다.

요구사항

• Node.js 22.22.2+ (22.x) 또는 24.15.0+ (24.x)
• 소스 개발 시 rustup 기반 Rust 1.85.1 (릴리스 아티팩트에는 네이티브 코어가 포함됨)
• npm, Git
• 이미 설치·인증된 지원 에이전트 CLI 1개 이상

소스에서 웹 앱 실행

git clone https://github.com/devswha/gajae-a