<div align="center">
<a href="https://github.com/Sunhaiy/Reflex">
<img src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/logo.png" alt="Reflex" height="72" />
</a>
<h1>Reflex</h1>
<p>
터미널 세션, SFTP, Docker, 라이브 모니터링 및 에이전트 네이티브 워크플로우를 하나의 데스크톱 앱에서 제공하는 현대적인 SSH 운영 작업 공간입니다.
</p>
<p>
<a href="./README.md">English</a>
|
<a href="./README.zh-CN.md">简体中文</a>
|
<a href="./README.ja.md">日本語</a>
|
<a href="./README.ko.md">한국어</a>
</p>
<p>
<a href="https://github.com/Sunhaiy/Reflex/actions/workflows/build-release.yml">
<img alt="Build" src="https://github.com/Sunhaiy/Reflex/actions/workflows/build-release.yml/badge.svg" />
</a>
<a href="https://github.com/Sunhaiy/Reflex/releases/latest">
<img alt="Release" src="https://img.shields.io/github/v/release/Sunhaiy/Reflex" />
</a>
<a href="./LICENSE">
<img alt="License" src="https://img.shields.io/badge/license-custom-111111?logo=opensourceinitiative" />
</a>
<img alt="Electron" src="https://img.shields.io/badge/Electron-43-47848F?logo=electron&logoColor=white" />
<img alt="Platforms" src="https://img.shields.io/badge/Windows%20%7C%20macOS%20%7C%20Linux-supported-0f766e" />
</p>
</div>
<p align="center">
<img alt="Reflex SSH workspace" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/workspace-real.png" width="100%" />
</p>
개요 (Overview)
Reflex는 실제 서버 작업(연결, 검사, 편집, 배포, 복구 및 작업을 전환하거나 앱을 다시 열어도 동일한 컨텍스트 유지)을 중심으로 구축된 크로스 플랫폼 SSH 데스크톱 클라이언트입니다.
이 앱은 집중적인 터미널 작업 공간과 실용적인 인프라 도구, 그리고 숨겨진 추론(reasoning)을 노출하지 않으면서 가시적인 서버 작업을 실행할 수 있는 Agent를 결합합니다. 연결 프로필, 환경 설정(preferences), 제공자 자격 증명(provider credentials), 그리고 Agent 기록은 애플리케이션 로컬에 유지됩니다.
<p align="center"><em lang="ko">훌륭한 소프트웨어는 사려 깊게 설계된 모든 디테일의 총합입니다.</em></p>
제품 투어 (Product tour)
<p align="center">
<img alt="Reflex Agent workspace" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/agent.png" width="100%" />
</p>
<p align="center">
<b lang="ko">Agent</b><br />가시적인 도구 단계(tool steps), 명령어, 결과 및 스트리밍 응답.
</p>
<p align="center">
<img alt="Reflex Docker workspace" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/docker.png" width="100%" />
</p>
<p align="center">
<b lang="ko">Docker</b><br />컨테이너, 이미지, 포트, 로그 및 라이프사이클 작업.
</p>
<p align="center">
<img alt="Reflex connection loading animation" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/media/en/connection.gif" width="100%" />
</p>
<p align="center">
<b lang="ko">연결 흐름 (Connection flow)</b><br />SSH 연결, 터미널, 파일 트리 및 모니터링 로드가 준비된 작업 공간으로 들어오는 모습.
</p>
<p align="center">
<img alt="Reflex Agent interaction animation" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/media/en/agent.gif" width="100%" />
</p>
<p align="center">
<b lang="ko">Agent 흐름 (Agent flow)</b><br />프롬프트, 도구 타임라인, 터미널 출력 및 연속적인 실행 내의 스트리밍 답변.
</p>
<p align="center">
<img alt="Reflex appearance settings" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/appearance-settings.png" width="100%" />
</p>
<p align="center">
<b lang="ko">외관 (Appearance)</b><br />테마, 강조 색상(accent color), 모서리 반경(radius) 및 글꼴.
</p>
<p align="center">
<img alt="Reflex terminal settings" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/terminal-settings.png" width="100%" />
</p>
<p align="center">
<b lang="ko">터미널 (Terminal)</b><br />렌더링, 커서, 타이포그래피 및 스크롤백.
</p>
<p align="center">
<img alt="Reflex application settings" src="https://raw.githubusercontent.com/Sunhaiy/Reflex/HEAD/docs/screenshots/en/application-settings.png" width="100%" />
</p>
Reflex를 사용하는 이유 (Why Reflex)
- 통합 원격 작업 공간: 터미널, 파일, Docker, 모니터링, Agent 액션이 나란히 유지됩니다.
- Agent 네이티브 실행: 원하는 결과(outcome)를 설명하면 보이는 명령어, 진행 상황, 승인 절차, 결과를 따라 수행합니다.
- 복구 가능한 세션: 터미널 상태와 Agent 대화 내용이 작업 전환 및 애플리케이션 재시작 후에도 유지됩니다.
- 로컬 우선 설정 (Local-first configuration): 연결 및 제공업체(provider) 설정이 장치에 저장됩니다.
- 크로스 플랫폼 출시: Windows, macOS Intel/Apple Silicon, Linux용으로 패키징되었습니다.
주요 기능 (Features)
터미널 및 SSH (Terminal and SSH)
- 다중 SSH 연결 및 터미널 세션 지원
- 비밀번호, 개인 키(private-key), 점프 호스트(jump-host) 인증 방식 지원
- 캔버스 또는 WebGL 렌더링, 사용자 정의 가능한 커서, 글꼴, 간격 및 테마 설정
- ANSI 터미널 스타일링을 유지하는 재연결 인식 명령어 실행 기능
Agent 작업 공간 (Agent workspace)
- 가시적인 진행 상황과 도구 출력이 포함된 자연어 서버 작업 수행
- 영속적이고, 전환 가능하며, 삭제 가능한 대화 기록
- 모델(Model), 제공업체(provider), 컨텍스트 예산(context budget), 추론 노력(reasoning-effort) 제어 기능
- 민감한 명령어 및 파일 변경에 대한 승인 처리 (Approval handling)
- 안전 링크와 복사 가능한 코드 블록이 포함된 마크다운 응답
파일 및 배포 (Files and deployment)
- SFTP 브라우징, 업로드, 다운로드, 이름 변경(rename), 편집, 삭제 및 디렉터리 생성 기능
- 원격 파일 미리 보기 및 에디터 워크플로우
- 디렉터리에 진입할 때 부드러운 스켈레톤-콘텐츠 전환
- 배포 지향적인 프로젝트 및 서버 준비 도구
서버 관리 (Server management)
- CPU, 메모리, 디스크, 네트워크 및 프로세스 모니터링 기능
- Docker 컨테이너, 이미지, 로그, 셸 접근 및 정리(cleanup) 기능
- 연결 사용 기록 및 빠른 프로필 검색 기능
- SSH가 연결되기 전에 요청하는 것을 방지하는 시작 준비 확인 절차 (Startup readiness checks)
개인화 (Personalization)
- 설정 가능한 강조 색상을 갖춘 시스템, 라이트, 다크 테마 지원
- 조정 가능한 모서리 반경 및 인터페이스/터미널 폰트 패밀리 제공
- 영어, 중국어 간체, 일본어, 한국어, 이탈리아어 UI 지원
다운로드
Windows, macOS, Linux용 설치 프로그램은 최신 릴리스에서 받을 수 있습니다.
개발
요구 사항: Node.js >=22.12.0 (Node.js 24 권장) 및 npm.
git clone https://github.com/Sunhaiy/Reflex.git
cd Reflex
npm ci
...
빌드 및 패키징:
npm run build
npm run dist
플랫폼별 패키징:
npm run dist:win
npm run dist:mac
npm run dist:linux
프로젝트 구조
electron/ Electron 메인 프로세스, IPC, SSH, SFTP, 모니터링 및 Agent 런타임
src/ React 렌더러, 애플리케이션 UI, 테마, 스토어 및 현지화
docs/ 문서화 에셋 및 정제된 제품 스크린샷
...
기술 스택
- Electron 43
- React 18 및 TypeScript
- Vite 8 및 Tailwind CSS
- Zustand
- xterm.js 및 ssh2
- React Markdown
보안
보안 문제는 SECURITY에 설명된 절차를 사용하여 신고해 주십시오. 공개 이슈에 자격 증명, 연결 프로필, 로그 또는 서버 주소를 게시하지 마십시오.
기여
기여를 환영합니다. 이슈나 풀 리퀘스트를 열기 전에 CONTRIBUTING 및 CODE_OF_CONDUCT를 읽어보세요.
라이선스
LICENSE 및 THIRD_PARTY_NOTICES를 참조하십시오.
