복잡한 코딩 작업을 위해 AI 에이전트에게 안정적이고 장기적인 터미널 환경을 제공하도록 설계된 지속적인 tmux 기반 세션 관리자입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install persistent-code-terminal
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 persistent-code-terminal 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Persistent Code Terminal란 무엇인가요?
Persistent Code Terminal은 일시적인 AI 채팅 세션과 안정적인 셸 환경 간의 격차를 해소하기 위해 설계된 강력한 유틸리티입니다. tmux를 사용하여 프로젝트별 세션을 생성함으로써, 이 도구는 연결이 끊어지더라도 코딩 작업, 개발 서버 및 빌드 프로세스가 활성 상태를 유지하도록 보장합니다. 이는 특히 모바일 기기나 원격 SSH 연결을 통해 AI 기반 워크플로우를 관리하는 개발자에게 Openclaw Skills 생태계 내에서 필수적인 자산입니다.
이 스킬은 여러 턴에 걸쳐 셸 상태가 보존되는 정교한 세션 관리를 가능하게 합니다. Codex CLI 및 Claude Code와 원활하게 통합되어 자율 코딩을 위한 신뢰할 수 있는 인프라를 제공합니다. project-name-code-session이라는 프로젝트별 세션을 유지함으로써 개발자는 출력이나 환경 컨텍스트를 잃지 않고 활성 작업에서 분리했다가 다시 연결할 수 있습니다.
Persistent Code Terminal 활용 사례
- 수분 또는 수시간 동안 안정성이 필요한 Codex CLI를 통한 장시간 AI 코딩 작업 실행.
- 각 리포지토리에 대한 전용 격리 셸 환경을 사용하여 여러 코딩 프로젝트를 동시에 관리.
- AI 에이전트가 다른 작업을 수행하는 동안 백그라운드에서 활성 개발 서버 또는 파일 감시자 유지.
- 연결 안정성을 보장할 수 없는 SSH 또는 모바일 인터페이스를 통한 원격 개발 작업 실행.
Persistent Code Terminal 작동 원리
- 이 스킬은 지속적인 환경을 보장하기 위해 start.sh 스크립트를 사용하여 특정 프로젝트에 대한 전용 tmux 세션을 초기화합니다.
- 명령은 send.sh 유틸리티를 통해 세션으로 전달되며, 이 유틸리티는 명령이 끝나는 시점을 추적하기 위해 고유한 센티널을 추가합니다.
- read.sh 스크립트는 세션 출력을 모니터링하고 종료 코드를 캡처하며 로컬 상태 추적 파일을 업데이트합니다.
- 지능형 라우팅 로직은 자연어 입력을 분석하여 사용자가 전체 Codex CLI 실행 체인을 트리거할지 아니면 단순한 터미널 명령을 실행할지 결정합니다.
- 상태 및 요약 스크립트는 터미널의 현재 상태와 실행 중인 작업의 진행 상황에 대한 구조화된 JSON 또는 markdown 피드백을 제공합니다.
Persistent Code Terminal 설정 가이드
이 스킬을 시작하려면 시스템에 tmux가 설치되어 있는지 확인하세요. 이는 대부분의 터미널 기반 Openclaw Skills의 주요 요구 사항입니다.
# Homebrew를 사용하여 macOS에 tmux 설치
brew install tmux
# Linux (Ubuntu/Debian)에 tmux 설치
sudo apt-get update && sudo apt-get install tmux
# 현재 프로젝트를 위한 지속적인 세션 초기화
./bin/persistent-code-terminal-start.sh
Persistent Code Terminal 데이터 스키마 및 분류 체계
이 스킬은 AI 에이전트가 항상 이전 터미널 작업의 컨텍스트를 가질 수 있도록 각 프로젝트 디렉토리 내에서 로컬로 상태를 관리합니다.
| 파일 | 설명 |
|---|---|
.pct-state.json |
세션 ID, 마지막 명령, 종료 코드 및 타임스탬프를 포함하는 기본 상태 파일입니다. |
*-code-session |
터미널 프로세스를 특정 프로젝트에 매핑하는 데 사용되는 tmux 세션 식별자입니다. |
상태 객체 속성:
projectDir: 프로젝트 루트의 절대 경로.session: 활성 tmux 세션의 이름.lastCommand: 터미널로 보낸 가장 최근 문자열.lastExitCode: 마지막으로 완료된 프로세스의 숫자 반환 코드.
Persistent Code Terminal 고급 기능
- 자연어 의도 감지: fix, build 또는 commit과 같은 키워드를 기반으로 메시지를 Codex CLI로 자동 라우팅합니다.
- 다중 프로젝트 지원: 여러 리포지토리에 걸친 복잡한 지침을 순차적으로 작업을 실행하여 처리합니다.
- Codex 우선 워크플로우: 구성 가능한 샌드박싱 및 보안 정책과 함께 codex exec를 활용하는 원샷 실행 모드입니다.
- 자동 재시도: 자율 코딩 작업에서 더 높은 성공률을 보장하기 위해 명령 실행에 대한 기본 제공 재시도 로직입니다.
- 구조화된 보고: 모든 주요 스크립트에 대해 --json 출력을 지원하여 사용자 정의 대시보드 또는 에이전트 루프에 쉽게 통합할 수 있습니다.
SKILL.md
로드 중
관련 Openclaw 스킬
에이전트 브라우저 (Agent Browser)
AI 에이전트가 영구 세션을 사용하여 웹 페이지를 탐색, 상호 작용 및 데이터 추출을 수행할 수 있도록 설계된 강력한 브라우저 자동화 CLI입니다.
YT-to-Blog 콘텐츠 엔진
단일 YouTube URL을 블로그, 소셜 스레드 및 AI 아바타 비디오를 포함한 완전한 크로스 플랫폼 콘텐츠 세트로 변환하는 포괄적인 AI 기반 파이프라인입니다.
GEDCOM Explorer
정적 GEDCOM 파일을 대화형 단일 파일 HTML 계보 대시보드로 변환하는 Python 기반 도구입니다.
Dory-Memory
세션 재설정 후에도 AI 에이전트가 작업 연속성과 컨텍스트를 유지할 수 있도록 보장하는 강력한 파일 기반 메모리 프레임워크입니다.
Moltforsale
자율 에이전트가 구조화된 HTTP API를 통해 상호 작용하고, 상태를 구축하며, 권력 행동을 실행하는 경쟁적인 소셜 아레나입니다.
Moltforsale
구조화된 API와 소셜 로직을 통해 자율 에이전트가 상호 작용하고, 게시하고, 지위를 경쟁하도록 설계된 소셜 아레나입니다.
추천*
