Agent-first persistence
에이전트 작업이 끊기지 않습니다
Named PTY sessions keep running after clients detach, so long agent tasks survive terminal churn.
이름을 붙인 PTY 세션은 클라이언트가 접속을 끊어도 계속 실행됩니다. 오래 걸리는 에이전트 작업은 터미널을 닫았다 다시 열어도 중단되지 않습니다.
Persistent terminals for AI agents
AI 에이전트 작업을 오래 유지하는 터미널
lterm keeps agents running.
lterm은 에이전트 작업을 끊기지 않게 유지합니다.
A lightweight tmux-compatible terminal session daemon for Claude Code, Codex CLI, Gemini CLI, OpenCode, cmux, and other terminal-first agent workflows.
Claude Code, Codex CLI, Gemini CLI, OpenCode, cmux 같은 터미널 기반 AI 에이전트 워크플로를 위해 만든 가벼운 tmux 호환 세션 데몬입니다.
agent session
$ lterm start -d -n codex -- codex created codex %0 $ lterm logs codex --start=-20 sanitized scrollback for review $ lterm resume codex reattached without restarting the agent
Why it exists
왜 쓰나요?
Use tmux for a full multiplexer. Use lterm when agents need a smaller, scriptable persistence layer.
완전한 멀티플렉서가 필요하면 tmux를 쓰면 됩니다. lterm은 에이전트 작업에 필요한 가벼운 세션 유지와 스크립트 자동화에 집중합니다.
tmux-compatible where agents expect it
에이전트 도구가 필요로 하는 tmux 호환성
A focused tmux-compat shim covers the commands common orchestration tools rely on.
오케스트레이션 도구가 자주 쓰는 명령을 tmux-compat shim으로 지원합니다.
Raw attach, safe reports
Raw 연결과 정제된 리포트
Attached PTY bytes stay raw for TUIs. Report surfaces strip terminal controls while preserving UTF-8 text.
TUI가 깨지지 않도록 PTY 연결에서는 바이트를 raw로 전달합니다. 대신 리포트 출력은 터미널 제어 코드를 제거하고 UTF-8 텍스트는 그대로 보존합니다.
Install
설치
Homebrew and npm are the easiest paths. Cargo from GitHub is useful for source-pinned installs.
Homebrew와 npm이 가장 간편합니다. 소스에서 특정 버전을 고정해 설치하려면 Cargo를 쓰세요.
Homebrew
Recommended on macOS when Homebrew is already your package manager.
macOS에서 Homebrew를 쓰고 있다면 가장 무난한 설치 방법입니다.
brew install ictechgy/tap/lterm
npm
Installs a wrapper plus native platform package on supported macOS/Linux targets.
지원되는 macOS/Linux 환경에서는 래퍼와 네이티브 패키지를 한 번에 설치합니다.
npm install -g @ictechgy/lterm
Cargo
Pin the release tag when installing from source; check GitHub Releases for newer tags.
소스에서 설치할 때는 릴리스 태그를 고정하세요. 최신 태그는 GitHub Releases에서 확인할 수 있습니다.
cargo install --locked --git https://github.com/ictechgy/light_terminal --tag v1.0.11
Quick start
빠른 시작
Create a named session, detach safely, inspect it, then resume when you need the live terminal.
이름을 붙인 세션을 시작하고, 안전하게 분리한 뒤, 필요할 때 다시 실시간 터미널에 연결합니다.
Start a persistent process
계속 실행할 프로세스 시작
lterm start -d -n api -- npm run dev
The process keeps running after your current terminal exits.
현재 터미널을 닫아도 프로세스는 계속 실행됩니다.
Read sanitized scrollback
정제된 scrollback 확인
lterm logs api --start=-80 --end=-1
Good for agents and scripts because terminal controls are stripped from report output.
리포트 출력에서는 터미널 제어 코드를 제거하므로 에이전트와 스크립트가 읽기 쉽습니다.
Resume the live terminal
실시간 터미널에 다시 연결하기
lterm resume api
Compatibility names such as attach, a, and -a remain available.
attach, a, -a 같은 호환 이름도 그대로 쓸 수 있습니다.
Command map
명령어 목록
These are the product CLI commands people and agents usually need first.
사람과 에이전트 모두 먼저 알아두면 좋은 주요 CLI 명령어입니다.
| Task | Command | Compatibility names |
|---|---|---|
| 작업 | 명령 | 호환 이름 |
| Start a persistent process | lterm start -n api -- npm run dev | new |
| 계속 실행할 프로세스 시작 | lterm start -n api -- npm run dev | new |
| Open or create a session | lterm open main | attach-or-new |
| 세션 열기 또는 생성 | lterm open main | attach-or-new |
| Resume a session | lterm resume api | attach, a, -a |
| 기존 세션에 다시 연결 | lterm resume api | attach, a, -a |
| Read sanitized scrollback | lterm logs api --start=-80 | capture |
| 정제된 scrollback 확인 | lterm logs api --start=-80 | capture |
| Wait for a marker or exit | lterm wait api --contains READY --timeout 30s --json | none |
| 마커가 나오거나 종료될 때까지 대기 | lterm wait api --contains READY --timeout 30s --json | 없음 |
| Notify on completion | lterm watch api --exit --notify | none |
| 완료 시 알림 | lterm watch api --exit --notify | 없음 |
| Launch an agent profile | lterm codex --name codex-main | agent profiles |
| 에이전트 프로파일 실행 | lterm codex --name codex-main | agent profiles |
| Diagnose local state | lterm doctor --json | status |
| 로컬 상태 진단 | lterm doctor --json | status |
Security model in plain language
보안 모델을 쉽게 말하면
lterm is a same-user convenience daemon. It is not a sandbox.
lterm은 같은 OS 사용자 범위 안에서 쓰는 편의 목적의 데몬입니다. 샌드박스가 아닙니다.
Attached terminals are raw. Full-screen apps, shells, and remote PTY streams can emit terminal escape sequences just like they can under tmux or screen.
연결된 터미널은 raw 모드입니다. 전체화면 앱, 셸, 원격 PTY 스트림은 tmux/screen에서와 마찬가지로 터미널 이스케이프 시퀀스를 출력할 수 있습니다.
Reports are sanitized. logs, capture, compose, diagnostics, and notification fallback paths strip terminal controls while preserving valid UTF-8 text.
리포트 출력은 정제됩니다. logs, capture, compose, 진단, 알림 폴백 경로에서는 터미널 제어 코드를 제거하고 유효한 UTF-8 텍스트를 보존합니다.