PIPER: 안전한 DevOps 작업을 위한 LLM 기반 터미널 코파일럿

섹션별 상세

LLM이 쉘 문자열을 직접 생성하는 대신, 시스템에 정의된 고정 카탈로그에서 작업명과 인자를 선택한다. 실행기(Executor)는 이 선택을 검증하고 미리 정의된 템플릿에 따라 명령을 실행하여 임의 코드 실행 위험을 차단한다.

json

{
  "name": "system.disk_usage",
  "args": { "host": "staging", "path": "/" }
}

LLM이 쉘 명령을 직접 생성하는 대신, 시스템에 정의된 카탈로그의 작업명과 인자를 JSON 형태로 호출하는 예시

PIPER를 사용하여 가상의 프로덕션 호스트를 진단하고 이상 징후를 분석하는 터미널 화면 — Screenshot이 이미지는 PIPER의 터미널 사용자 인터페이스(TUI)를 보여준다. 사용자가 명령을 내리고, LLM이 계획을 수립하며, 결정론적 게이트를 거쳐 안전하게 명령이 실행되는 과정을 시각적으로 확인할 수 있다.

근거

PIPER는 LLM이 직접 쉘을 실행하지 않고, 고정된 작업 카탈로그에서 명령을 선택한다. — Catalog actions, not LLM-generated shell

Zod를 통한 인자 검증, 비밀 정보 필터링, 경로 차단 목록(Denylist) 적용 등 다중 방어 체계를 갖춘다. LLM이 생성한 명령은 실행 전 반드시 검증 과정을 거치며, 검증 실패 시 실행이 거부된다.

읽기 전용 진단 작업은 즉시 실행되지만, 인프라를 변경하거나 파괴적인 작업은 반드시 인간의 명시적 승인을 요구한다. 이 과정은 기억되지 않으며 매번 확인을 거쳐 사고를 방지한다.

근거

모든 변경 작업은 인간의 승인을 거치며, 읽기 전용 작업은 즉시 실행된다. — Three permission tiers with no overrides

Bun, PGlite, pgvector를 사용하여 모든 데이터와 처리가 로컬 머신에서 수행된다. 외부 API 호출은 추론을 위한 LLM 연결로 제한되며, 민감한 인프라 정보가 외부로 유출되지 않도록 설계됐다.

json

{
  "openrouter_api_key": "sk-or-v1-...",
  "default_provider": "openrouter",
  "default_model": "deepseek/deepseek-v4-pro",
  "embedding_backend": "wasm",
  "max_session_cost_usd": 0.50
}

PIPER의 설정 파일(~/.piper/credentials.json) 예시

용어 해설

PGlite: — WebAssembly(WASM) 기반으로 브라우저나 Node.js 환경에서 실행되는 경량 PostgreSQL 데이터베이스이다. 별도의 서버 설치 없이 로컬 환경에서 관계형 데이터베이스와 벡터 검색 기능을 제공한다.
pgvector: — PostgreSQL을 위한 오픈 소스 벡터 유사도 검색 확장 기능이다. 고차원 벡터 데이터를 저장하고 HNSW 인덱스를 통해 효율적인 유사도 검색을 지원하여 RAG 시스템 구축에 필수적이다.
터미널 사용자 인터페이스(TUI): — 그래픽 대신 텍스트 기반의 터미널 환경에서 작동하는 사용자 인터페이스이다. PIPER는 Ink 라이브러리를 사용하여 터미널 내에서 대화형 UI를 구현한다.
인간 개입형 프로세스(Human-in-the-loop): — AI 시스템의 자동화 과정 중에 인간의 확인이나 승인을 필수 단계로 포함하는 설계 방식이다. PIPER는 파괴적인 명령 실행 시 이 방식을 통해 사고를 방지한다.

기술

TypeScript
Bun
PGlite
pgvector
Ink

활용 사례

인프라 진단 및 로그 분석
리소스 모니터링
안전한 인프라 변경 작업

언급된 리소스

GitHubPIPER GitHub Repository

섹션별 상세

json

{
  "name": "system.disk_usage",
  "args": { "host": "staging", "path": "/" }
}

LLM이 쉘 명령을 직접 생성하는 대신, 시스템에 정의된 카탈로그의 작업명과 인자를 JSON 형태로 호출하는 예시

근거

PIPER는 LLM이 직접 쉘을 실행하지 않고, 고정된 작업 카탈로그에서 명령을 선택한다. — Catalog actions, not LLM-generated shell

근거

모든 변경 작업은 인간의 승인을 거치며, 읽기 전용 작업은 즉시 실행된다. — Three permission tiers with no overrides

json

{
  "openrouter_api_key": "sk-or-v1-...",
  "default_provider": "openrouter",
  "default_model": "deepseek/deepseek-v4-pro",
  "embedding_backend": "wasm",
  "max_session_cost_usd": 0.50
}

PIPER의 설정 파일(~/.piper/credentials.json) 예시

용어 해설

PGlite: — WebAssembly(WASM) 기반으로 브라우저나 Node.js 환경에서 실행되는 경량 PostgreSQL 데이터베이스이다. 별도의 서버 설치 없이 로컬 환경에서 관계형 데이터베이스와 벡터 검색 기능을 제공한다.
pgvector: — PostgreSQL을 위한 오픈 소스 벡터 유사도 검색 확장 기능이다. 고차원 벡터 데이터를 저장하고 HNSW 인덱스를 통해 효율적인 유사도 검색을 지원하여 RAG 시스템 구축에 필수적이다.
터미널 사용자 인터페이스(TUI): — 그래픽 대신 텍스트 기반의 터미널 환경에서 작동하는 사용자 인터페이스이다. PIPER는 Ink 라이브러리를 사용하여 터미널 내에서 대화형 UI를 구현한다.
인간 개입형 프로세스(Human-in-the-loop): — AI 시스템의 자동화 과정 중에 인간의 확인이나 승인을 필수 단계로 포함하는 설계 방식이다. PIPER는 파괴적인 명령 실행 시 이 방식을 통해 사고를 방지한다.

기술

TypeScript
Bun
PGlite
pgvector
Ink

활용 사례

인프라 진단 및 로그 분석
리소스 모니터링
안전한 인프라 변경 작업

언급된 리소스

GitHubPIPER GitHub Repository

PIPER: 안전한 DevOps 작업을 위한 LLM 기반 터미널 코파일럿

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

PIPER: 안전한 DevOps 작업을 위한 LLM 기반 터미널 코파일럿

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드