xgen-cli-agent

xgen 플랫폼을 터미널에서 제어하는 CLI 및 TUI 도구입니다. A CLI/TUI tool for controlling the xgen platform from the terminal.

---

빠른 시작 / Quick Start

빌드 (Build)

cd xgen-cli-agent
cargo build --release
# 실행 파일: target/release/xgen (Linux/macOS) 또는 target/release/xgen.exe (Windows)

서버 설정 (Configure Server)

xgen config set server_url http://localhost:3000  # Next.js 프론트엔드 URL
# 또는 backend-gateway 직접 접근:
# xgen config set server_url http://localhost:8000

로그인 (Login)

xgen login
# 브라우저가 열리면 xgen 계정으로 로그인하세요

---

CLI 명령 참조 / CLI Command Reference

인증 (Authentication)

xgen login              # 브라우저 OAuth(PKCE) 로그인
xgen logout             # 현재 세션 로그아웃
xgen status             # 로그인 상태 및 서버 정보 확인

설정 (Config)

xgen config set server_url <URL>   # 서버 URL 설정
xgen config get server_url         # 설정값 조회
xgen config list                   # 전체 설정 목록

문서 관리 (Documents)

# 컬렉션 목록 조회
xgen docs collections

# 컬렉션 내 문서 목록 조회
xgen docs list <collection>
xgen docs list <collection> --page 2 --limit 50

# 문서 업로드 (컬렉션 지정 필수)
xgen docs upload ./report.pdf --collection my-collection

# 문서 상세 정보 조회 (파일 경로 또는 ID)
xgen docs info <file_path_or_id>

# 문서 삭제 (컬렉션 지정 필수)
xgen docs delete <id> --collection my-collection
xgen docs delete <id> --collection my-collection --force   # 확인 없이 삭제

워크플로우 (Workflow)

# 워크플로우 목록 조회
xgen workflow list

# 워크플로우 상세 정보 및 입력 파라미터 확인
xgen workflow info <id>

# 워크플로우 실행 (SSE 스트리밍)
xgen workflow run <id>
xgen workflow run <id> --input "사용자 질문"              # 텍스트 입력
xgen workflow run <id> --input '{"query": "안녕"}'        # JSON 입력

# 실행 상태 조회
xgen workflow status <execution_id>

TUI 인터페이스

xgen tui    # TUI 인터페이스 실행

셸 자동완성 (Shell Completions)

# Bash: ~/.bashrc 에 추가
eval "$(xgen completions bash)"

# Zsh: ~/.zshrc 에 추가
eval "$(xgen completions zsh)"

# Fish: 파일로 저장
xgen completions fish > ~/.config/fish/completions/xgen.fish

# PowerShell: $PROFILE 에 추가
Invoke-Expression (xgen completions powershell)
# 또는 영구 설치:
xgen completions powershell | Out-File -Append $PROFILE

자동완성은 워크플로우 ID, 컬렉션 이름, 문서 ID를 동적으로 제안합니다.

전역 플래그 (Global Flags)

xgen --verbose <command>    # 요청/응답 상세 출력 (-v 단축키 사용 가능)

---

TUI 단축키 / TUI Shortcuts

키	기능
Tab	메뉴 전환 (홈/문서/워크플로우)
↑↓	항목 이동
Enter	상세 보기
r	실행 (워크플로우) / 새로고침 (문서)
d	삭제
ESC	뒤로가기
?	도움말
q	종료

---

상세 문서 / Detailed Documentation

한국어	English
아키텍처	Architecture
로직 상세	Logic Details
개발 현황	Progress
TODO	TODO

---

요구사항 / Requirements

• Rust 1.75+
• xgen 서버 (xgen-backend-gateway + xgen-frontend)
• OS keychain 지원 (선택사항, 없으면 파일 기반 토큰 저장)