XOps CLI
<div align="center">
<img src="https://raw.githubusercontent.com/wentf9/xops-cli/HEAD/docs/public/logo.svg" width="88" alt="XOps CLI Logo" />
<h3>단일 바이너리, 제로 원격 의존성을 가진 현대 터미널 운영 및 AI 자동화 도구 상자</h3>
<p><b>SSH / SFTP · 터미널 TUI · 오프라인 암호화 자격 증명 저장소 · 배치 병렬 실행 · YAML Playbook · 제어된 MCP 서비스 및 Agent Skill</b></p>
<p>
<img alt="Go Version" src="https://img.shields.io/badge/Go-1.26+-00ADD8?style=flat-square&logo=go" />
<img alt="Platform" src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-4c8bf5?style=flat-square" />
<img alt="MCP Ready" src="https://img.shields.io/badge/AI-MCP%20%26%20Agent%20Skill-8A2BE2?style=flat-square" />
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-2ea44f?style=flat-square" /></a>
</p>
<p>
<a href="https://wentf9.github.io/xops-cli/"><b>📖 온라인 문서</b></a> ·
<a href="https://wentf9.github.io/xops-cli/guide/getting-started"><b>🚀 빠른 시작</b></a> ·
<a href="https://wentf9.github.io/xops-cli/reference/"><b>⌨️ 명령어 참고</b></a> ·
<a href="docs/troubleshooting/index.md"><b>🔧 문제 해결</b></a> ·
<a href="README_en.md"><b>English</b></a>
</p>
</div>
일상적인 운영 및 인프라 관리에서, 다음 도구들 사이를 자주 오가시나요:
~/.ssh/config 파일을 직접 작성하거나, 비밀번호 입력 없이 사용하기 위해 평문 비밀번호를 Shell 히스토리에 남기는 sshpass를 사용하는 경우?- 수십 대의 장비를 다룰 때, Ansible / Python 환경을 구축하는 것이 너무 무겁게 느껴져서, 단순히 단일 파일 바이너리로 명령 실행, 파일 전송, 상태 수렴(state convergence)만 하고 싶은 경우?
- Alpine 컨테이너(Bash 없음), Windows OpenSSH(CMD / PowerShell) 또는 fish/zsh 노드에 연결할 때, 스크립트가 셸 방언(Shell dialect) 비호환성 때문에 오류를 일으키는 경우?
- Claude, Codex, Cursor와 같은 AI 어시스턴트를 사용해 서버 문제 해결 및 운영을 맡기고 싶지만, 권한을 열어준 후 AI가 위험도가 높은 명령어를 오작동으로 실행할까 봐 걱정되는 경우?
XOps CLI는 이러한 모든 기능을 하나의 크로스 플랫폼 Go 바이너리 파일에 통합합니다: 제로 원격 의존성, 기본적으로 로컬 암호화 저장소 사용, 목표 셸 환경 자동 감지 기능은 물론, 위험 방지 장치(risk guardrail)와 승인 감사(approval audit)가 적용된 MCP 서버 및 AI Agent Skill을 네이티브하게 제공합니다.
⚡ 30초 만에 초고속 시작
curl -fsSL https://raw.githubusercontent.com/wentf9/xops-cli/master/install.sh | bash
# Windows에서 PowerShell 5.1 이상에서 설치 (x64 / ARM64 지원, 관리자 권한 불필요):
im https://raw.githubusercontent.com/wentf9/xops-cli/master/install.ps1 | iex
소스 코드 컴파일 (Go 1.26+ 필요, Makefile은 Linux, macOS 및 Windows를 네이티브 지원):
git clone https://github.com/wentf9/xops-cli.git && cd xops-cli && make build
✨ XOps CLI를 선택해야 하는 이유?
| 문제 상황 | XOps CLI의 해결책 |
|---|
| 복잡하고 안전하지 않은 비밀번호 관리 | 일회 인증 및 암호화 기억: 최초 연결 인증을 통과하면, 로그인 비밀번호, 개인 키 암호(passphrase), 그리고 sudo/su 비밀번호가 로컬의 ~/.xops/credentials/에 자동으로 암호화되어 저장됩니다 (시스템 네이티브 Keychain, pass, 또는 사용자 정의 helper도 지원). YAML 설정 파일에는 절대로 평문 비밀번호가 노출되지 않습니다. |
| ... | |
🛠️ 핵심 기능 개요
1. 호스트 자산, 자동 프로빙 및 암호화 자격 증명
XOps는 네트워크 주소(Host), 인증 신원(Identity), 연결 노드(Node)를 분리하여 관리합니다. 동일한 IP에 대해 여러 권한의 계정을 연관시킬 수 있습니다:
xops host import hosts.csv --tag web
...
- 선(先) 검증 후(後) 저장:
ssh, sftp, scp, exec를 통해 새로운 호스트에 처음 연결할 때, SSH 핸드셰이크 및 인증이 성공한 경우에만 노드를 저장합니다. 연결 시간 초과나 비밀번호 오류는 불필요한 기록을 남기지 않습니다.
- 유연한 저장 전략: 단일 연결 시
--remember never를 추가하여 비밀번호 기억을 금지할 수 있으며, 설정에서 credential.remember_prompted: ask | never와 같이 지정할 수 있습니다. 오프라인으로 추가하거나 가져올 때는 --skip-verify (또는 --no-probe)를 사용하여 Shell 프로빙을 건너뛸 수 있습니다.
- 상세 정보: 호스트 및 신원 · 자격 증명 저장소 · 오프라인 자격 증명 라이브러리 · 자격 증명 마이그레이션
2. 강화된 SSH, 권한 상승 및 대화형 SFTP
xops ssh web-01
xops ssh audit@web-01
...
3. 병렬 일괄 실행 및 YAML 플레이북
xops exec --tag web --exclude web-maint-01 -c "uptime"
...
YAML을 사용하여 선언적 Playbook (deploy.yaml)을 작성하고 멱등(Idempotent) 배포를 구현할 수 있습니다:
name: deploy-web
targets:
tags: [web]
...
xops play deploy.yaml --dry-run
xops play deploy.yaml --var app_port=8081 --limit web-01
4. AI 연동: MCP 서버 및 에이전트 스킬
XOps는 서로 보완적인 두 가지 AI 연동 방식을 제공하여 다양한 클라이언트에 적합합니다:
방식 A: 내장 MCP 서버 (Claude Desktop / Cursor / Codex / Antigravity)
claude_desktop_config.json에 연결:
{
"mcpServers": {
"xops": {
...
- 내장 안전 장치 (Guardrail): 명령어 및 경로 위험을 자동으로 평가하며, 고위험 작업 발생 시 클라이언트 대화형 승인 양식을 트리거합니다. 승인 기간 동안 목표 설정이 변조될 경우 권한은 자동으로 취소되며, 모든 과정은 감사 로그(audit log)에 완전히 기록됩니다.
- 자세히 보기: MCP HTTP 및 파일 전송 · MCP SSH 터널링
방식 B: xops-agent Skill (AI가 터미널에서 직접 CLI를 조작하도록 함)
MCP 서비스를 시작할 필요 없이, 단 한 줄의 명령어로 Skill을 지원하는 Agent에 xops-agent 작동 규범을 설치합니다:
npx skills add https://github.com/wentf9/xops-cli --skill xops-agent
수동 설치는 skills/xops-agent/ 디렉토리를 직접 복사할 수 있습니다 (SKILL.md 및 references/ 유지). 자세한 내용은 Agent Skill 가이드를 참조하세요.
📄 오픈소스 라이선스
본 프로젝트는 MIT License 기반으로 오픈소스를 공개합니다. XOps CLI가 일상적인 운영(Ops) 또는 AI 워크플로우에 도움이 되었다면, **Star ⭐**를 눌러 프로젝트 발전을 지지해 주세요!