AgentSkillsCN

ethos-cli

通过 CLI 查询 Ethos Network 的声誉数据。当用户询问以下内容时，此功能将为您提供支持： - 查找用户资料、评分或声誉（Ethos 用户信息/摘要） - 检查用户之间的担保、评价或惩罚 - 查询 XP 余额、排行榜名次或赛季进度 - 探索信任市场、挂牌交易或经纪人的帖子 - 寻找验证者 NFT 或拍卖信息 触发条件包括：“Ethos 声誉”、“查询评分”、“谁为……担保”、“信任市场”、“Ethos 个人资料”、“Ethos 上的评价”

SKILL.md
--- frontmatter
name: ethos-cli
description: |
  Query Ethos Network reputation data via CLI. Use when users ask about:
  - Looking up user profiles, scores, or reputation (ethos user info/summary)
  - Checking vouches, reviews, or slashes between users
  - Querying XP balances, leaderboard ranks, or seasons
  - Exploring trust markets, listings, or broker posts
  - Finding validator NFTs or auctions
  Triggers: "ethos reputation", "check score", "who vouched for", "trust market", "ethos profile", "review on ethos"
allowed-tools: Bash(ethos:*)

Ethos CLI

Read-only CLI for querying Ethos Network reputation data.

Installation

bash
npm install -g @trust-ethos/cli

User Identification

All commands accept flexible identifiers:

FormatExample
Twitter usernamesethgho, 0xNowater
ETH address0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
ENS namevitalik.eth

Commands

User

bash
ethos user info <user>           # Profile with score level
ethos user summary <user>        # Profile + activity + vouches
ethos user activity <user>       # Recent reviews/vouches
ethos user search <query>        # Find users
ethos user invitations <user>    # Invitations sent

Vouches

bash
ethos vouch list <user>          # Vouches received
ethos vouch list --author <user> # Vouches given
ethos vouch info <id>            # Vouch details
ethos vouch mutual <u1> <u2>     # Mutual vouchers
ethos vouch votes <id>           # Votes on vouch

Reviews

bash
ethos review list <user>         # Reviews for user
ethos review info <id>           # Review details
ethos review votes <id>          # Votes on review

Slashes

bash
ethos slash list                 # All slashes
ethos slash info <id>            # Slash details
ethos slash votes <id>           # Votes on slash

XP

bash
ethos xp rank <user>             # Leaderboard position
ethos xp rank <user> --season 2  # Specific season
ethos xp seasons                 # List seasons

Trust Markets

bash
ethos market list                # All markets
ethos market info <user>         # User's market
ethos market holders <user>      # Trust/distrust holders
ethos market featured            # Top gainers/losers

Projects/Listings

bash
ethos listing list               # Active listings
ethos listing info <id>          # Project details
ethos listing voters <id>        # Bullish/bearish voters

Broker Posts

bash
ethos broker list                # All posts
ethos broker list --type hire    # Filter: sell|buy|hire|for-hire|bounty
ethos broker info <id>           # Post details

Validators & Auctions

bash
ethos validator list             # All validators
ethos validator info <tokenId>   # Validator details
ethos validator sales            # For sale on OpenSea
ethos auction list               # All auctions
ethos auction active             # Current auction
ethos auction info <id>          # Auction details

Configuration

bash
ethos config get                 # Show config
ethos config set apiUrl=<url>    # Set API
ethos config path                # Config location

Global Flags

All commands support:

  • •--json / -j — JSON output
  • •--verbose / -v — Detailed errors
  • •--limit / -l — Results limit (default: 10)
  • •--offset / -o — Pagination offset

Score Levels

RangeLevel
< 800UNTRUSTED
800-1199QUESTIONABLE
1200-1599NEUTRAL
1600-1999REPUTABLE
2000+EXEMPLARY

Common Patterns

bash
# Quick lookup
ethos user info vitalik.eth

# Full picture
ethos user summary sethgho

# Mutual connections
ethos vouch mutual sethgho 0xNowater

# Script with jq
ethos user info sethgho --json | jq '.score'
ethos vouch list sethgho --json | jq '.values[].balance'

Exit Codes

  • •0 — Success
  • •1 — Runtime error
  • •2 — Invalid usage