Xops Cli README

# 1. 一键安装（Linux / macOS）
curl -fsSL https://raw.githubusercontent.com/wentf9/xops-cli/master/install.sh | bash

# Windows 在 PowerShell 5.1+ 中安装（支持 x64 / ARM64，无需管理员权限）：
irm https://raw.githubusercontent.com/wentf9/xops-cli/master/install.ps1 | iex

# 2. 导入现有的 ~/.ssh/config（纯本地读取，不连远端，不覆盖已有节点）
xops init

# 3. 直接连接任意主机 —— 首次验证成功后自动保存节点，并将密码/口令加密存入本机凭据库
xops ssh root@192.0.2.10

# 4. 打开交互式终端管理面板（SSH 会话、实时系统监控、远端日志搜索、标签管理）
xops tui

# 从 CSV 批量导入主机并打上 web 标签（默认验证 SSH 连接并自动探测保存远端 Shell 配置）
xops host import hosts.csv --tag web

# 手动添加单台主机
xops host add --address 192.0.2.10 --user deploy --key ~/.ssh/id_ed25519 --alias web-01 --tags web

# 查看主机列表、标签，或诊断节点的远端 OS 与可用解释器
xops host list
xops host probe web-01
xops host probe --all --save

# 检查凭据存储健康状态
xops credential store list
xops credential doctor

# 通过别名快速登录，或以其他用户连接同一台主机（自动复用 Host 并隔离凭据）
xops ssh web-01
xops ssh audit@web-01

# 跳板机穿透（支持多级 ProxyJump、直连 IP/FQDN 或已保存的节点别名）
xops ssh -J bastion.example.com -i ~/.ssh/id_rsa root@192.0.2.13

# 免开放 root SSH 登录：普通用户连接后自动完成 sudo / sudo-rs / su 提权握手
xops ssh --sudo web-01
xops exec -x --sudo web-01 id

# 端口转发与 SOCKS5 动态代理（内置智能心跳保活与断线自动清理）
xops ssh -L 8080:127.0.0.1:80 -D 1080 -N web-01

# 交互式 SFTP 终端（支持 Tab 跨页路径补全、Ctrl+R 历史搜索、当前远端目录下 exec 命令）
xops sftp web-01

# 对 web 标签组的所有主机并行执行命令（排除维护节点）
xops exec --tag web --exclude web-maint-01 -c "uptime"

# 并发分发并执行本地脚本（并发度 5）
xops exec --tag web --shell ./setup.sh --task 5

# 批量分发配置文件到目标服务器群
xops scp --tag web ./config.conf /etc/app/

name: deploy-web
targets:
  tags: [web]
settings:
  concurrency: 2
  on_error: stop # 可选 stop | abort_all | continue
vars:
  app_port: "8080"
steps:
  - name: "确保 nginx 已安装"
    ensure:
      check: "nginx -v"
      action: "apt-get update && apt-get install -y nginx"
    sudo: true

  - name: "渲染并分发配置"
    template:
      src: "./nginx.conf.tmpl"
      dest: "/etc/nginx/nginx.conf"
    sudo: true

  - name: "启动 nginx 服务"
    shell: "systemctl restart nginx"
    sudo: true

# 预览执行计划（Dry Run）与正式运行
xops play deploy.yaml --dry-run
xops play deploy.yaml --var app_port=8081 --limit web-01

# 本地 stdio 模式启动（提供节点查询、命令执行、SFTP 文件读写与 -L/-R SSH 隧道工具）
xops mcp serve

# 局域网 Streamable HTTP 模式启动（支持 Bearer Token 认证与 10 GiB 级流式文件上下传）
xops mcp serve --transport http --listen 0.0.0.0:8080 \
  --public-url http://192.168.1.10:8080 --token-file ~/.xops/mcp.token

{
  "mcpServers": {
    "xops": {
      "command": "/usr/local/bin/xops",
      "args": ["mcp", "serve"]
    }
  }
}

npx skills add https://github.com/wentf9/xops-cli --skill xops-agent