hoop — Agent Guide

No conflict-matrix pairs for this tool yet.

# Hoop — Agent Guide

name: hoop ｜ version_range: 0.3.2~0.3.2｜ generated: 2026-08-28

title_en: Hoop - Unified Protocol Gateway ｜ desc_en: One policy surface for MCP, LLM and databases, with hsh gateway CLI and privileged tunnel daemon.

Preflight

note: Linux x86_64; full install requires systemd + sudo.

uname -m && [ -d /run/systemd/system ] && echo systemd-ok || echo no-systemd

预期输出: see command output

Install

note: gh-proxy acceleration recommended in mainland China. Method A (CLI) verified; Method B (daemon) not tested (requires systemd + sudo).

Method A: CLI layer

note: Verified in this environment.

curl -sL -o hsh.tar.gz https://gh-proxy.com/https://github.com/hoophq/hsh/releases/download/v0.3.2/hsh-linux-x64.tar.gz
tar xzf hsh.tar.gz
./hsh-linux-x64/hsh --version

预期输出: 0.3.2 (hsh-tunneld 1.86.0)

Method B: Full install (CLI + privileged daemon)

note: Official install.sh; not tested in this environment — requires systemd + sudo.

curl -sL -o hsh-tunneld https://gh-proxy.com/https://github.com/hoophq/hoop/releases/download/1.150.1/hsh-tunneld-linux-amd64
# 与 install.sh 同目录后执行：sudo ./install.sh（自动写 systemd 单元 + 建 hsh 组 + 启服务）

预期输出: daemon install success message (systemd enable + restart)

Operations

View status

note: Verified in this environment.

hsh status

预期输出: Version 0.3.2 + API URL (unconfigured) + Auth (unauthenticated) + Plugins (ssh, kubectl)

Configure gateway address

hsh config set api-url https://your-hoop-gateway

预期输出: config written to ~/.hsh/

Login

note: Requires a gateway.

hsh login

预期输出: auth flow (token stored in ~/.hsh/)

Issue a temporary kubeconfig

note: Requires auth + connection.

hsh kubeconfig prod-db

预期输出: temporary kubeconfig path (for k9s/helm/kubectl)

Tunnel control

note: Requires the daemon.

hsh tunnel status

预期输出: hsh-tunneld daemon status (prompted when not installed)

Uninstall

note: CLI layer auto-cleaned; daemon layer uses official uninstall.sh (privileged install not tested).

rm -rf ~/.hsh
rm -f /usr/local/bin/hsh /usr/local/bin/hsh-tunneld
sudo systemctl stop hsh-tunneld 2>/dev/null || true
command -v hsh >/dev/null 2>&1 && echo '残留: hsh 仍存在' || echo 'hoop removed: OK'

预期输出: hoop removed: OK

Facts

writes: ~/.hsh/ ｜ runtime: Linux x86_64, CLI; systemd + sudo for daemon ｜ notes: privileged hsh-tunneld daemon only in full install (not tested); no persistent process in CLI-only mode

Source: hoop · validated 2026-08-28 · v0.3.2~0.3.2

← Agent index