LociTerm - AI 에이전트 SSH 세션 단절問題を解決するpersistent 웹 터미널

Show GN: LociTerm - AI 에이전트 SSH 세션이 계속 끊겨서 persistent 웹 터미널을 만들었습니다

AI 코딩 에이전트가 장시간 SSH 세션에서 작업하다 보면, 네트워크 단절이나 세션 타임아웃으로 작업 환경이 통째로 사라지는 문제가 있습니다. 브라우저를 닫은 순간 에이전트의 빌드 환경, vim 상태, 실행 중인 프로세스가 전부 증발하는 것이죠. 한국 개발자 Younkyum이 만든 LociTerm은 이 문제를 근본적으로 해결하는 persistent 웹 터미널입니다.

LociTerm이란?

LociTerm은 AI 네이티브 개발 환경을 위한 persistent 워크스페이스입니다. 서버에서 Claude Code나 기타 장시간 실행되는 셸 프로세스를 실행하고, 브라우저를 닫거나 기기를 바꿔도 시간이 지나도 에이전트, 빌드 상태, vim이 그대로 유지됩니다. 내부적으로는 tmux을 사용하면서도 외부는 실제 UI로 감싸서 개발자에게 친숙한 경험을 제공합니다.

핵심 특징

• tmux 기반 persistence: 서버 쪽에서 tmux 세션을 유지하므로 네트워크 단절에 영향 없음

• 실시간 웹 UI: 브라우저에서 실제 터미널 UI로 접속 가능

• 크로스 디바이스 지원: 노트북 → 데스크탑 → 태블릿으로 이동해도 같은 세션 유지

• 다중 에이전트 동시 관리: 여러 AI 에이전트의 터미널을 하나의 인터페이스에서 관리

설치 및 설정 방법

LociTerm은 GitHub에서 오픈소스로 공개되어 있으며, 간단한 설정만으로 사용할 수 있습니다.

# GitHub에서 클론git clone https://github.com/Younkyum/Loci-Terminal.gitcd Loci-Terminal# Docker 환경에서 실행 (권장)docker-compose up -d# 또는 직접 실행pip install loci-termloci-term start

설정 파일을 통해 포트, 인증 옵션, tmux 세션 관리 방식을 사용자에게 맞게 조정할 수 있습니다. 기본값으로도 대부분의 환경에서 바로 작동합니다.

Docker Compose 설정 예시

version: '3.8'services:loci-term:image: ghcr.io/younkyum/loci-term:latestports:- "8080:8080"volumes:- /var/run/docker.sock:/var/run/docker.sockenvironment:- TMUX_SOCKET_PATH=/tmp/tmuxrestart: unless-stopped

tmux vs LociTerm: 무엇이 다른가?

기존에도 tmux이나 screen을용래 서버 세션을 유지할 수 있었습니다. 하지만 이들은 CLI 도구이기 때문에 웹 환경에서 실시간으로 터미널을monitoring하거나 에이전트와 협업하기 어렵습니다.

구분	tmux/screen	LociTerm
웹 UI	없음	있음 (실시간 스트리밍)
다중 에이전트 관리	불가능	가능 ( painel 통합)
네트워크 단절 복구	수동	자동 (세션 자동 복원)
외부 공유	마번	링크 하나로 공유 가능
설정 난이도	높음	낮음 (Docker 한 방)

LociTerm은 tmux의 persistence를 그대로 가져오면서, 웹 UI 레이어를 입혀서 로컬 서버의 터미널을 브라우저에서 마치 로컬 프로그램처럼 사용할 수 있게 합니다.

AI 에이전트와 함께 사용하는 패턴

Claude Code와 연계

Claude Code를 서버에서 실행하고 LociTerm으로 접속하면, 에이전트가 장시간 빌드를 진행하는 동안에도 로컬에서 다른 작업을 할 수 있습니다. 네트워크가 끊어져도 tmux이 세션을 유지하므로 돌아와서 바로 이어서 작업할 수 있습니다.

# 서버에서 Claude Code 실행ssh servertmux new -s claude-agentclaude-code# LociTerm 웹 UI로 접속하여 모니터링# → 에이전트의 작업 진행 상황을 실시간으로 확인

CI/CD 파이프라인과의 차이

기존 CI/CD 환경에서는 빌드 서버가ephemeral해서 매번 새 환경에서 시작해야 했습니다. LociTerm을 사용하면 에이전트가 하나의 영속적인 워크스페이스를 갖게 되어, 대규모 리팩토링이나 수십 분이 걸리는 빌드를 안정적으로 수행할 수 있습니다.

성능과 보안

LociTerm은 WebSocket 기반으로 실시간 터미널 스트리밍을 구현합니다. 터미널 출력은 서버에서 클라이언트로 실시간 전송되지만, 입력 이벤트는최소적으로만 전송되므로 네트워크 대역폭을 적게 사용합니다.

보안 측면에서는 TLS 암호화 지원, 세션 단위 인증 토큰, 그리고 tmux 세션은 서버 내부에서만 동작하여 외부 노출이 최소화됩니다. 기본 설정에서도 Docker 네트워크 격리와 인증 레이어가 적용됩니다.

향후 발전 방향

LociTerm은 현재 Version 0.x 단계로, 활발히 개발 중인 프로젝트입니다. 향후 멀티 유저 지원, 팀 기반 세션 공유, 그리고 VS Code Extension 연동이 계획되어 있습니다. AI 에이전트 워크스페이스 persistence는 앞으로 개발 환경의 표준이 될 가능성이 높으며, LociTerm이 이 분야의 선두 주자로 자리매김하고 있습니다.

요약

LociTerm은 AI 코딩 에이전트의 영속적 작업 환경 문제를 tmux 기반 웹 터미널로 해결하는 도구입니다. 네트워크 단절에도 세션이 유지되고, 다양한 기기에서 같은 작업 환경을 이어갈 수 있어 장시간 실행되는 AI 에이전트 개발에 필수적인 도구입니다. GitHub에서 오픈소스로 공개되어 있으므로, 직접 설치해서 자신의 개발 환경에 맞춰 커스터마이징할 수도 있습니다.

---

핵심 정리

• 문제: SSH 세션 단절로 AI 에이전트의 작업 환경이 사라짐

• 해결: tmux 기반 persistent 웹 터미널 LociTerm

• 장점: 네트워크 단절 복구, 크로스 디바이스, 다중 에이전트 관리

• 설치: Docker Compose로 한 방에 설정 가능

• 활용: Claude Code 등 AI 에이전트의 장시간 작업 환경으로 최적

tags: AI에이전트, SSH, tmux, 웹터미널, 개발도구, LociTerm, ClaudeCode, AI개발환경, PersistentSession, DevTools

---

📚 출처

• https://news.hada.io/topic?id=29323