LiveAgent: LiveAgent – 파일을 읽고 쓸 수 있으며, 셸 명령을 실행하고 웹 게이트웨이를 통해 원격으로 접속할 수 있는 로컬 우선 데스크톱 AI 어시스턴트.

무엇인가요

LiveAgent는 대규모 언어 모델(LLM) 기반의 agent가 사용자의 컴퓨터에서 동작할 수 있게 해주는 크로스 플랫폼 데스크톱 클라이언트(macOS, Windows, Linux)입니다. 다음과 같은 기능을 수행할 수 있습니다:

• Claude, OpenAI Codex, Gemini 또는 지정한 모든 호환 가능한 API와 대화할 수 있습니다.
• 파일을 읽고, 편집하고, 생성하고, 삭제하며, glob/regex로 검색하고 Bash 명령을 실행할 수 있습니다.
• 장기 실행 프로세스를 유지하고 원클릭 터널을 통해 인터넷에 노출할 수 있습니다.
• 대화 기록과 지식을 로컬 SQLite + Markdown 저장소에 보관합니다.
• 예약된 작업(cron-like)을 실행하고 세션 전반에 걸쳐 문맥을 기억합니다. 모든 기능은 데스크톱에서 offline으로 작동합니다. 동일한 agent를 모든 브라우저에서 제어하고 싶다면 별도의 Go 기반 Gateway를 배포할 수 있습니다.

핵심 구성 요소

구성 요소	기술 스택	역할
Agent GUI	Tauri 2 + React 19 + Rust (Tokio)	데스크톱 UI, 로컬 도구 브리지, SQLite 메모리, LLM SDKs
Gateway	Go 1.25	WebSocket/HTTP 릴레이, Web UI, 원격 제어 API (Docker-ready)
MCP protocol	stdio / HTTP bridge	서드파티 도구 또는 "Skills" 패키지를 agent에 연결할 수 있게 합니다
Skills ecosystem	"ClawHub" 패키지	온디맨드 확장 기능 (예: 코드 포맷터, 웹 스크래퍼)

시작하기

1. Download 최신 GitHub Release에서 적절한 설치 프로그램을 다운로드하세요 (DMG, EXE/MSI/portable zip, AppImage, DEB 또는 RPM). 해당되는 경우 앱은 서명/공증을 받았습니다.
2. Run 데스크톱 클라이언트를 실행하고, API 키를 추가하세요 (로컬 머신에만 저장됨). 그 후 채팅을 시작하세요.
3. Optional – remote access: Docker 이미지 ghcr.io/stack-cairn/liveagent-gateway:latest를 가져오고(pull), 토큰과 함께 실행한 후, 데스크톱 Settings → Remote 페이지에서 게이트웨이 URL을 지정하세요. TLS를 위한 Nginx reverse-proxy 설정이 제공됩니다.

내부 작동 원리

• UI는 Tauri의 IPC를 통해 Rust 백엔드와 통신합니다. 백엔드는 각 SDK를 사용하여 LLM 제공업체(Claude, Codex, Gemini)와 통신하며 선택된 모델에 따라 요청을 라우팅합니다.
• 파일 시스템 및 Bash 기능은 명령을 감독하고, 작업 디렉토리와 타임아웃을 강제하며, 서비스를 유지할 수 있는 ManagedProcess 레이어를 통해 노출됩니다.
• 대화 기록은 분할된 메시지와 주기적인 요약 체크포인트로 저장되어, agent가 긴 대화 후에도 문맥을 유지할 수 있게 합니다.
• SQLite FTS 인덱스를 통해 전체 텍스트 쿼리로 과거 지식을 검색할 수 있습니다.
• Gateway는 데스크톱 클라이언트가 사용하는 것과 동일한 WebSocket 프로토콜을 미러링하므로, 브라우저 UI에서 동일한 명령을을 내릴 수 있습니다. 짧은 네트워크 끊김은 제한된 시퀀스 윈도우를 다시 재생하여 복원됩니다.

누가 사용할 수 있나요

• 터미널을 떠나지 않고 코드를 편집하거나, 빌드를 실행하거나, 로컬 개발 서버를 관리할 수 있는 AI를 원하는 개발자.
• 파일을 조작하고, 스크립트를 예약하고, 검색 가능한 지식 베이스를 유지할 수 있는 개인용 어시스턴트가 필요한 파워 유저.
• 공유 agent를 위한 셀프 호스팅 원격 UI를 원하는 팀 (예: Docker gateway를 통해).

라이선스 및 기여

이 프로젝트는 MIT 라이선스 하에 출시되었습니다. 기여는 언제나 환영합니다. 레포지토리는 TypeScript, Rust, Go에 대한 CI 체크를 포함하며, 공통 개발 명령이 포함된 Makefile과 커뮤니티 기여자를 보여주는 contrib.rocks 배지를 포함합니다.