@trust-ethos/cli

v0.0.16

Published

2 days ago

Official Ethos CLI - Query user profiles, XP balances, and reputation data

0High
0Medium
0Low

0xnowater

serpinxbt

ethos-vitalii

ethos reputation xp web3 cli

@trust-ethos/cli

      .............         ..........     ..  ...                              
       ............         ...     ..    ..    ..                              
.........                   ...      .  ......  .. ....       .....      ...... 
.........                   ...     .     .. .  ...  .....  ...   ...  ..    .. 
         ..........         .........     ..    ..     ... ...     ... ...    . 
         ..........         ...   ...     ..    ..     ... ...      ..  .....   
..........                  ...           ..    ..     ... ...      ..     .... 
.........                   ...       ..  ..    ..     ... ...     ... .     ...
       ............         ...      ..   ..    ..     ...  ...    ..  ..    ...
      .............         ...........  ....  ....    ...   .......   ........

Official Ethos CLI - Query user profiles, XP balances, and reputation data

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/trust-ethos/ethos-cli/main/scripts/install.sh | sh

This installs the CLI to ~/.ethos/ and automatically keeps it up to date.

npm

npm install -g @trust-ethos/cli
# or
bun install -g @trust-ethos/cli

Homebrew

brew tap trust-ethos/tap
brew install ethos

From Source

git clone https://github.com/trust-ethos/ethos-cli.git
cd ethos-cli
bun install
bun run build
npm link

To unlink: npm unlink -g @trust-ethos/cli

Updates

The CLI handles updates differently depending on how you installed it:

| Install Method | Update Behavior | |----------------|-----------------| | curl | Auto-updates silently in the background | | npm | Shows update notification, run npm update -g @trust-ethos/cli | | Homebrew | Shows update notification, run brew upgrade ethos |

For curl installs, updates are checked daily and applied automatically on the next CLI run.

Usage

User Commands

Get user profile (includes score, XP, stats)

ethos user info 0xNowater              # Twitter username
ethos user info vitalik.eth            # ENS name
ethos user info 0xd8dA6BF2...          # ETH address
ethos user info 0xNowater --json       # JSON output

Search for users

ethos user search vitalik
ethos user search "crypto developer" --limit 5
ethos user search web3 --json

XP Commands

List XP seasons

ethos xp seasons
ethos xp seasons --json

Check leaderboard rank

ethos xp rank 0xNowater
ethos xp rank vitalik.eth --json

Identifier Formats

The CLI intelligently detects identifier types:

| Format | Example | Detection | |--------|---------|-----------| | Twitter username | 0xNowater | Default (plain text) | | ETH address | 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 | 0x + 40 hex chars | | ENS name | vitalik.eth | Ends with .eth | | Explicit prefix | twitter:name, address:0x..., profileId:21 | Colon-prefixed |

JSON Output

All commands support --json (or -j) flag for machine-readable output:

ethos user info 0xNowater --json | jq .score
ethos user search vitalik --json | jq '.values[0].username'
ethos xp rank 0xNowater --json | jq .rank

Shell Completions

Generate shell completions for your shell:

# Bash
ethos autocomplete bash

# Zsh
ethos autocomplete zsh

# Fish
ethos autocomplete fish

Follow the printed instructions to add completions to your shell.

Configuration

Configure the CLI using the config command:

# Show current configuration
ethos config get

# Set the API URL
ethos config set apiUrl=https://api.ethos.network

# Show config file path
ethos config path

The config file is stored at ~/.config/ethos/config.json.

Exit Codes

0 - Success
1 - Runtime error (API failure, not found)
2 - Invalid usage (missing args, validation error)

Development

Setup

git clone https://github.com/trust-ethos/ethos-cli.git
cd ethos-cli
bun install

Commands

bun run dev              # Run CLI in development mode
bun run build            # Build TypeScript
bun test                 # Run tests
bun run test:watch       # Run tests in watch mode
bun run typecheck        # Type check without building
bun run lint             # Lint code
bun run readme           # Generate README command reference

Project Structure

ethos-cli/
├── src/
│   ├── commands/        # Command implementations
│   │   ├── user/        # User-related commands
│   │   └── xp/          # XP-related commands
│   ├── lib/
│   │   ├── api/         # API client
│   │   ├── formatting/  # Output formatting
│   │   └── validation/  # Input validation
│   └── index.ts
├── test/                # Test files
├── bin/                 # Entry points
└── dist/                # Built output

LLM Agent Integration

This CLI is designed to be agent-friendly:

All commands support --json for structured output
Semantic exit codes for programmatic error handling
Environment variables for configuration
Stable output schemas (versioned with package)

See SKILL.md for detailed LLM agent integration guide.

Contributing

Contributions are welcome! Please read CLAUDE.md for development guidelines.

License

MIT License - see LICENSE file for details.

Links

$ npm install -g @trust-ethos/cli
$ ethos COMMAND
running command...
$ ethos (--version)
@trust-ethos/cli/0.0.16 linux-x64 node-v22.22.0
$ ethos --help [COMMAND]
USAGE
  $ ethos COMMAND
...

`ethos auction active`

Show the currently active auction

USAGE
  $ ethos auction active [-j] [-v]

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Show the currently active auction

EXAMPLES
  $ ethos auction active

  $ ethos auction active --json

See code: src/commands/auction/active.ts

`ethos auction info ID`

Get details of a specific auction

USAGE
  $ ethos auction info ID [-j] [-v]

ARGUMENTS
  ID  Auction ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific auction

EXAMPLES
  $ ethos auction info 1

  $ ethos auction info 1 --json

See code: src/commands/auction/info.ts

`ethos auction list`

List validator NFT auctions

USAGE
  $ ethos auction list [-j] [-v] [-l <value>] [-o <value>] [--status pending|active|ended|settled]

FLAGS
  -j, --json             Output as JSON
  -l, --limit=<value>    [default: 10] Max results per request
  -o, --offset=<value>   Number of results to skip
  -v, --verbose          Show detailed error information
      --status=<option>  Filter by status
                         <options: pending|active|ended|settled>

DESCRIPTION
  List validator NFT auctions

EXAMPLES
  $ ethos auction list

  $ ethos auction list --status active

  $ ethos auction list --json

See code: src/commands/auction/list.ts

`ethos autocomplete [SHELL]`

Display autocomplete installation instructions.

USAGE
  $ ethos autocomplete [SHELL] [-r]

ARGUMENTS
  [SHELL]  (zsh|bash|powershell) Shell type

FLAGS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

DESCRIPTION
  Display autocomplete installation instructions.

EXAMPLES
  $ ethos autocomplete

  $ ethos autocomplete bash

  $ ethos autocomplete zsh

  $ ethos autocomplete powershell

  $ ethos autocomplete --refresh-cache

See code: @oclif/plugin-autocomplete

`ethos broker info ID`

Get details of a specific broker post

USAGE
  $ ethos broker info ID [-j] [-v]

ARGUMENTS
  ID  Broker post ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific broker post

EXAMPLES
  $ ethos broker info 123

  $ ethos broker info 123 --json

See code: src/commands/broker/info.ts

`ethos broker list`

List broker posts (jobs, services, bounties)

USAGE
  $ ethos broker list [-j] [-v] [-l <value>] [-o <value>] [-s <value>] [--sort newest|top|hot] [-t
    sell|buy|hire|for-hire|bounty]

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --search=<value>  Search in title/description
  -t, --type=<option>   Filter by post type
                        <options: sell|buy|hire|for-hire|bounty>
  -v, --verbose         Show detailed error information
      --sort=<option>   [default: hot] Sort order
                        <options: newest|top|hot>

DESCRIPTION
  List broker posts (jobs, services, bounties)

EXAMPLES
  $ ethos broker list

  $ ethos broker list --type hire

  $ ethos broker list --search "solidity developer"

  $ ethos broker list --type sell --limit 5 --json

See code: src/commands/broker/list.ts

`ethos config get`

Show current configuration

USAGE
  $ ethos config get [-j]

FLAGS
  -j, --json  Output as JSON

DESCRIPTION
  Show current configuration

EXAMPLES
  $ ethos config get

  $ ethos config get --json

See code: src/commands/config/get.ts

`ethos config path`

Show config file path

USAGE
  $ ethos config path

DESCRIPTION
  Show config file path

EXAMPLES
  $ ethos config path

See code: src/commands/config/path.ts

`ethos config set VALUE`

Set configuration value

USAGE
  $ ethos config set VALUE

ARGUMENTS
  VALUE  Configuration in format: apiUrl=<url>

DESCRIPTION
  Set configuration value

EXAMPLES
  $ ethos config set apiUrl=https://api.ethos.network

  $ ethos config set apiUrl=https://api.dev.ethos.network

See code: src/commands/config/set.ts

`ethos find QUERY`

Search for users by name, username, or address

USAGE
  $ ethos find QUERY [-j] [-v] [-l <value>]

ARGUMENTS
  QUERY  Search query

FLAGS
  -j, --json           Output as JSON
  -l, --limit=<value>  [default: 10] Maximum number of results
  -v, --verbose        Show detailed error information

DESCRIPTION
  Search for users by name, username, or address

ALIASES
  $ ethos find

EXAMPLES
  $ ethos find vitalik

  $ ethos find "crypto developer"

  $ ethos find vitalik --json

  $ ethos find web3 --limit 5

`ethos help [COMMAND]`

Display help for ethos.

USAGE
  $ ethos help [COMMAND...] [-n]

ARGUMENTS
  [COMMAND...]  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for ethos.

See code: @oclif/plugin-help

`ethos listing info IDENTIFIER`

Get details of a specific listing/project

USAGE
  $ ethos listing info IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Project ID or username

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific listing/project

EXAMPLES
  $ ethos listing info 123

  $ ethos listing info uniswap

  $ ethos listing info uniswap --json

See code: src/commands/listing/info.ts

`ethos listing list`

List projects on Ethos Listings

USAGE
  $ ethos listing list [-j] [-v] [-l <value>] [-o <value>] [--status active|pending|archived]

FLAGS
  -j, --json             Output as JSON
  -l, --limit=<value>    [default: 10] Max results per request
  -o, --offset=<value>   Number of results to skip
  -v, --verbose          Show detailed error information
      --status=<option>  [default: active] Filter by status
                         <options: active|pending|archived>

DESCRIPTION
  List projects on Ethos Listings

EXAMPLES
  $ ethos listing list

  $ ethos listing list --status active

  $ ethos listing list --limit 20 --json

See code: src/commands/listing/list.ts

`ethos listing voters PROJECTID`

Show voters for a listing/project

USAGE
  $ ethos listing voters PROJECTID [-j] [-v] [-l <value>] [-o <value>] [--sentiment bullish|bearish]

ARGUMENTS
  PROJECTID  Project ID

FLAGS
  -j, --json                Output as JSON
  -l, --limit=<value>       [default: 10] Max results per request
  -o, --offset=<value>      Number of results to skip
  -v, --verbose             Show detailed error information
      --sentiment=<option>  Filter by sentiment
                            <options: bullish|bearish>

DESCRIPTION
  Show voters for a listing/project

EXAMPLES
  $ ethos listing voters 123

  $ ethos listing voters 123 --sentiment bullish

  $ ethos listing voters 123 --limit 20 --json

See code: src/commands/listing/voters.ts

`ethos market featured`

Show top gainers and losers

USAGE
  $ ethos market featured [-j] [-v]

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Show top gainers and losers

EXAMPLES
  $ ethos market featured

  $ ethos market featured --json

See code: src/commands/market/featured.ts

`ethos market holders IDENTIFIER`

Show who holds trust/distrust in a user

USAGE
  $ ethos market holders IDENTIFIER [-j] [-v] [-l <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json           Output as JSON
  -l, --limit=<value>  [default: 10] Max results
  -v, --verbose        Show detailed error information

DESCRIPTION
  Show who holds trust/distrust in a user

EXAMPLES
  $ ethos market holders sethgho

  $ ethos market holders 0xNowater --limit 20

  $ ethos market holders vitalik.eth --json

See code: src/commands/market/holders.ts

`ethos market info IDENTIFIER`

Get trust market info for a user

USAGE
  $ ethos market info IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Profile ID or Twitter username

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get trust market info for a user

ALIASES
  $ ethos mi

EXAMPLES
  $ ethos market info 123

  $ ethos market info vitalik

  $ ethos market info vitalik --json

See code: src/commands/market/info.ts

`ethos market list`

List trust markets

USAGE
  $ ethos market list [-j] [-v] [-l <value>] [-o <value>] [--order asc|desc] [-s <value>] [--sort
    marketCapWei|volume24hWei|priceChange24hPercent|score|createdAt]

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --search=<value>  Search by name/username
  -v, --verbose         Show detailed error information
      --order=<option>  [default: desc] Sort direction
                        <options: asc|desc>
      --sort=<option>   [default: marketCapWei] Sort by field
                        <options: marketCapWei|volume24hWei|priceChange24hPercent|score|createdAt>

DESCRIPTION
  List trust markets

ALIASES
  $ ethos ml

EXAMPLES
  $ ethos market list

  $ ethos market list --sort priceChange24hPercent --order desc

  $ ethos market list --search "vitalik" --json

See code: src/commands/market/list.ts

`ethos mi IDENTIFIER`

Get trust market info for a user

USAGE
  $ ethos mi IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Profile ID or Twitter username

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get trust market info for a user

ALIASES
  $ ethos mi

EXAMPLES
  $ ethos mi 123

  $ ethos mi vitalik

  $ ethos mi vitalik --json

`ethos ml`

List trust markets

USAGE
  $ ethos ml [-j] [-v] [-l <value>] [-o <value>] [--order asc|desc] [-s <value>] [--sort
    marketCapWei|volume24hWei|priceChange24hPercent|score|createdAt]

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --search=<value>  Search by name/username
  -v, --verbose         Show detailed error information
      --order=<option>  [default: desc] Sort direction
                        <options: asc|desc>
      --sort=<option>   [default: marketCapWei] Sort by field
                        <options: marketCapWei|volume24hWei|priceChange24hPercent|score|createdAt>

DESCRIPTION
  List trust markets

ALIASES
  $ ethos ml

EXAMPLES
  $ ethos ml

  $ ethos ml --sort priceChange24hPercent --order desc

  $ ethos ml --search "vitalik" --json

`ethos nft list IDENTIFIER`

List NFTs owned by a user

USAGE
  $ ethos nft list IDENTIFIER [-j] [-v] [-l <value>] [-o <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information

DESCRIPTION
  List NFTs owned by a user

EXAMPLES
  $ ethos nft list sethgho

  $ ethos nft list 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

  $ ethos nft list vitalik.eth --json

See code: src/commands/nft/list.ts

`ethos rank IDENTIFIER`

Show leaderboard rank for a user

USAGE
  $ ethos rank IDENTIFIER [-j] [-v] [-s <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json            Output as JSON
  -s, --season=<value>  Show XP for specific season
  -v, --verbose         Show detailed error information

DESCRIPTION
  Show leaderboard rank for a user

ALIASES
  $ ethos rank

EXAMPLES
  $ ethos rank 0xNowater

  $ ethos rank 0xNowater --season 2

  $ ethos rank 0xNowater --json

`ethos review info ID`

Get details of a specific review

USAGE
  $ ethos review info ID [-j] [-v]

ARGUMENTS
  ID  Review ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific review

ALIASES
  $ ethos ri

EXAMPLES
  $ ethos review info 1139

  $ ethos review info 1139 --json

See code: src/commands/review/info.ts

`ethos review list IDENTIFIER`

List reviews for a user

USAGE
  $ ethos review list IDENTIFIER [-j] [-v] [-l <value>] [-o <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information

DESCRIPTION
  List reviews for a user

ALIASES
  $ ethos rl

EXAMPLES
  $ ethos review list sethgho

  $ ethos review list 0xNowater --limit 20

  $ ethos review list vitalik.eth --json

See code: src/commands/review/list.ts

`ethos review votes ID`

Show votes on a review

USAGE
  $ ethos review votes ID [-j] [-v] [--downvotes | --upvotes] [-l <value>] [-o <value>] [-s]

ARGUMENTS
  ID  Review ID

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --stats           Show vote statistics only
  -v, --verbose         Show detailed error information
      --downvotes       Show only downvotes
      --upvotes         Show only upvotes

DESCRIPTION
  Show votes on a review

EXAMPLES
  $ ethos review votes 123

  $ ethos review votes 123 --stats

  $ ethos review votes 123 --upvotes

  $ ethos review votes 123 --json

See code: src/commands/review/votes.ts

`ethos ri ID`

Get details of a specific review

USAGE
  $ ethos ri ID [-j] [-v]

ARGUMENTS
  ID  Review ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific review

ALIASES
  $ ethos ri

EXAMPLES
  $ ethos ri 1139

  $ ethos ri 1139 --json

`ethos rl IDENTIFIER`

List reviews for a user

USAGE
  $ ethos rl IDENTIFIER [-j] [-v] [-l <value>] [-o <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information

DESCRIPTION
  List reviews for a user

ALIASES
  $ ethos rl

EXAMPLES
  $ ethos rl sethgho

  $ ethos rl 0xNowater --limit 20

  $ ethos rl vitalik.eth --json

`ethos score status IDENTIFIER`

Check score calculation status for a user

USAGE
  $ ethos score status IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Check score calculation status for a user

EXAMPLES
  $ ethos score status 0xNowater

  $ ethos score status vitalik.eth

  $ ethos score status 0xNowater --json

See code: src/commands/score/status.ts

`ethos skill install`

Install the ethos-cli skill for AI coding agents

USAGE
  $ ethos skill install [-y]

FLAGS
  -y, --yes  Skip confirmation prompts

DESCRIPTION
  Install the ethos-cli skill for AI coding agents

EXAMPLES
  $ ethos skill install

  $ ethos skill install --yes

See code: src/commands/skill/install.ts

`ethos slash info ID`

Get details of a specific slash

USAGE
  $ ethos slash info ID [-j] [-v]

ARGUMENTS
  ID  Slash ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific slash

EXAMPLES
  $ ethos slash info 123

  $ ethos slash info 123 --json

See code: src/commands/slash/info.ts

`ethos slash list`

List reputation slashes

USAGE
  $ ethos slash list [-j] [-v] [--author <value>] [-l <value>] [-o <value>] [--status open|closed] [--subject
    <value>]

FLAGS
  -j, --json             Output as JSON
  -l, --limit=<value>    [default: 10] Max results per request
  -o, --offset=<value>   Number of results to skip
  -v, --verbose          Show detailed error information
      --author=<value>   Filter by slasher userkey
      --status=<option>  Filter by status
                         <options: open|closed>
      --subject=<value>  Filter by subject userkey

DESCRIPTION
  List reputation slashes

EXAMPLES
  $ ethos slash list

  $ ethos slash list --status open

  $ ethos slash list --subject twitter:0xNowater

  $ ethos slash list --limit 5 --json

See code: src/commands/slash/list.ts

`ethos slash votes ID`

Show votes on a slash

USAGE
  $ ethos slash votes ID [-j] [-v] [--downvotes | --upvotes] [-l <value>] [-o <value>] [-s]

ARGUMENTS
  ID  Slash ID

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --stats           Show vote statistics only
  -v, --verbose         Show detailed error information
      --downvotes       Show only downvotes
      --upvotes         Show only upvotes

DESCRIPTION
  Show votes on a slash

EXAMPLES
  $ ethos slash votes 195

  $ ethos slash votes 195 --stats

  $ ethos slash votes 195 --upvotes

  $ ethos slash votes 195 --json

See code: src/commands/slash/votes.ts

`ethos u IDENTIFIER`

Display user profile by username, address, or ENS name

USAGE
  $ ethos u IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Display user profile by username, address, or ENS name

ALIASES
  $ ethos u
  $ ethos ui

EXAMPLES
  $ ethos u 0xNowater

  $ ethos u 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

  $ ethos u vitalik.eth

  $ ethos u 0xNowater --json

`ethos ui IDENTIFIER`

Display user profile by username, address, or ENS name

USAGE
  $ ethos ui IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Display user profile by username, address, or ENS name

ALIASES
  $ ethos u
  $ ethos ui

EXAMPLES
  $ ethos ui 0xNowater

  $ ethos ui 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

  $ ethos ui vitalik.eth

  $ ethos ui 0xNowater --json

`ethos update`

Update the CLI to the latest version

USAGE
  $ ethos update [-f]

FLAGS
  -f, --force  Force update even if already on latest

DESCRIPTION
  Update the CLI to the latest version

EXAMPLES
  $ ethos update

  $ ethos update --force

See code: src/commands/update.ts

`ethos us IDENTIFIER`

Display comprehensive user summary with activity and vouches

USAGE
  $ ethos us IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Display comprehensive user summary with activity and vouches

ALIASES
  $ ethos us

EXAMPLES
  $ ethos us sethgho

  $ ethos us 0xNowater

  $ ethos us vitalik.eth --json

`ethos user activity IDENTIFIER`

Show recent reviews and vouches for a user

USAGE
  $ ethos user activity IDENTIFIER [-j] [-v] [-l <value>] [-t vouch|review]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json           Output as JSON
  -l, --limit=<value>  [default: 10] Maximum number of activities
  -t, --type=<option>  Filter by activity type
                       <options: vouch|review>
  -v, --verbose        Show detailed error information

DESCRIPTION
  Show recent reviews and vouches for a user

EXAMPLES
  $ ethos user activity 0xNowater

  $ ethos user activity 0xNowater --type vouch

  $ ethos user activity 0xNowater --type review --limit 5

  $ ethos user activity 0xNowater --json

See code: src/commands/user/activity.ts

`ethos user info IDENTIFIER`

Display user profile by username, address, or ENS name

USAGE
  $ ethos user info IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Display user profile by username, address, or ENS name

ALIASES
  $ ethos u
  $ ethos ui

EXAMPLES
  $ ethos user info 0xNowater

  $ ethos user info 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

  $ ethos user info vitalik.eth

  $ ethos user info 0xNowater --json

See code: src/commands/user/info.ts

`ethos user invitations IDENTIFIER`

List invitations sent by a user

USAGE
  $ ethos user invitations IDENTIFIER [-j] [-v] [-l <value>] [-o <value>] [-s INVITED|ACCEPTED]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json             Output as JSON
  -l, --limit=<value>    [default: 10] Max results per request
  -o, --offset=<value>   Number of results to skip
  -s, --status=<option>  Filter by status
                         <options: INVITED|ACCEPTED>
  -v, --verbose          Show detailed error information

DESCRIPTION
  List invitations sent by a user

EXAMPLES
  $ ethos user invitations sethgho

  $ ethos user invitations 0xNowater --status ACCEPTED

  $ ethos user invitations vitalik.eth --json

See code: src/commands/user/invitations.ts

`ethos user search QUERY`

Search for users by name, username, or address

USAGE
  $ ethos user search QUERY [-j] [-v] [-l <value>]

ARGUMENTS
  QUERY  Search query

FLAGS
  -j, --json           Output as JSON
  -l, --limit=<value>  [default: 10] Maximum number of results
  -v, --verbose        Show detailed error information

DESCRIPTION
  Search for users by name, username, or address

ALIASES
  $ ethos find

EXAMPLES
  $ ethos user search vitalik

  $ ethos user search "crypto developer"

  $ ethos user search vitalik --json

  $ ethos user search web3 --limit 5

See code: src/commands/user/search.ts

`ethos user summary IDENTIFIER`

Display comprehensive user summary with activity and vouches

USAGE
  $ ethos user summary IDENTIFIER [-j] [-v]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Display comprehensive user summary with activity and vouches

ALIASES
  $ ethos us

EXAMPLES
  $ ethos user summary sethgho

  $ ethos user summary 0xNowater

  $ ethos user summary vitalik.eth --json

See code: src/commands/user/summary.ts

`ethos validator info TOKENID`

Get details of a specific validator NFT

USAGE
  $ ethos validator info TOKENID [-j] [-v]

ARGUMENTS
  TOKENID  Validator token ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific validator NFT

EXAMPLES
  $ ethos validator info 1

  $ ethos validator info 42 --json

See code: src/commands/validator/info.ts

`ethos validator list`

List all Ethos validator NFT owners

USAGE
  $ ethos validator list [-j] [-v] [-a] [-l <value>] [-o <value>]

FLAGS
  -a, --available       Show only validators with remaining XP capacity
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results to display
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information

DESCRIPTION
  List all Ethos validator NFT owners

EXAMPLES
  $ ethos validator list

  $ ethos validator list --limit 20

  $ ethos validator list --available

  $ ethos validator list --json

See code: src/commands/validator/list.ts

`ethos validator sales`

List validator NFTs for sale on OpenSea

USAGE
  $ ethos validator sales [-j] [-v] [-l <value>] [-o <value>]

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information

DESCRIPTION
  List validator NFTs for sale on OpenSea

EXAMPLES
  $ ethos validator sales

  $ ethos validator sales --limit 20 --json

See code: src/commands/validator/sales.ts

`ethos vi ID`

Get details of a specific vouch

USAGE
  $ ethos vi ID [-j] [-v]

ARGUMENTS
  ID  Vouch ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific vouch

ALIASES
  $ ethos vi

EXAMPLES
  $ ethos vi 123

  $ ethos vi 123 --json

`ethos vl [IDENTIFIER]`

List vouches for a user or all vouches

USAGE
  $ ethos vl [IDENTIFIER] [-j] [-v] [--active] [--author <value>] [-l <value>] [-o <value>]

ARGUMENTS
  [IDENTIFIER]  Twitter username, ETH address, or ENS name (optional, filter by subject)

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information
      --active          Show only active (non-archived) vouches
      --author=<value>  Filter by author (Twitter username, ETH address, or ENS name)

DESCRIPTION
  List vouches for a user or all vouches

ALIASES
  $ ethos vl

EXAMPLES
  $ ethos vl

  $ ethos vl 0xNowater

  $ ethos vl --author 0xNowater

  $ ethos vl --active

  $ ethos vl --limit 20 --json

`ethos vouch info ID`

Get details of a specific vouch

USAGE
  $ ethos vouch info ID [-j] [-v]

ARGUMENTS
  ID  Vouch ID

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  Get details of a specific vouch

ALIASES
  $ ethos vi

EXAMPLES
  $ ethos vouch info 123

  $ ethos vouch info 123 --json

See code: src/commands/vouch/info.ts

`ethos vouch list [IDENTIFIER]`

List vouches for a user or all vouches

USAGE
  $ ethos vouch list [IDENTIFIER] [-j] [-v] [--active] [--author <value>] [-l <value>] [-o <value>]

ARGUMENTS
  [IDENTIFIER]  Twitter username, ETH address, or ENS name (optional, filter by subject)

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -v, --verbose         Show detailed error information
      --active          Show only active (non-archived) vouches
      --author=<value>  Filter by author (Twitter username, ETH address, or ENS name)

DESCRIPTION
  List vouches for a user or all vouches

ALIASES
  $ ethos vl

EXAMPLES
  $ ethos vouch list

  $ ethos vouch list 0xNowater

  $ ethos vouch list --author 0xNowater

  $ ethos vouch list --active

  $ ethos vouch list --limit 20 --json

See code: src/commands/vouch/list.ts

`ethos vouch mutual TARGET VIEWER`

Find mutual vouchers between two users

USAGE
  $ ethos vouch mutual TARGET VIEWER [-j] [-v] [-l <value>]

ARGUMENTS
  TARGET  Target user (Twitter username, ETH address, or ENS name)
  VIEWER  Viewer user (Twitter username, ETH address, or ENS name)

FLAGS
  -j, --json           Output as JSON
  -l, --limit=<value>  [default: 10] Max results
  -v, --verbose        Show detailed error information

DESCRIPTION
  Find mutual vouchers between two users

EXAMPLES
  $ ethos vouch mutual 0xNowater VitalikButerin

  $ ethos vouch mutual 0xNowater VitalikButerin --limit 20

  $ ethos vouch mutual 0xNowater VitalikButerin --json

See code: src/commands/vouch/mutual.ts

`ethos vouch votes ID`

Show votes on a vouch

USAGE
  $ ethos vouch votes ID [-j] [-v] [--downvotes | --upvotes] [-l <value>] [-o <value>] [-s]

ARGUMENTS
  ID  Vouch ID

FLAGS
  -j, --json            Output as JSON
  -l, --limit=<value>   [default: 10] Max results per request
  -o, --offset=<value>  Number of results to skip
  -s, --stats           Show vote statistics only
  -v, --verbose         Show detailed error information
      --downvotes       Show only downvotes
      --upvotes         Show only upvotes

DESCRIPTION
  Show votes on a vouch

EXAMPLES
  $ ethos vouch votes 182

  $ ethos vouch votes 182 --stats

  $ ethos vouch votes 182 --upvotes

  $ ethos vouch votes 182 --json

See code: src/commands/vouch/votes.ts

`ethos xp rank IDENTIFIER`

Show leaderboard rank for a user

USAGE
  $ ethos xp rank IDENTIFIER [-j] [-v] [-s <value>]

ARGUMENTS
  IDENTIFIER  Twitter username, ETH address, or ENS name

FLAGS
  -j, --json            Output as JSON
  -s, --season=<value>  Show XP for specific season
  -v, --verbose         Show detailed error information

DESCRIPTION
  Show leaderboard rank for a user

ALIASES
  $ ethos rank

EXAMPLES
  $ ethos xp rank 0xNowater

  $ ethos xp rank 0xNowater --season 2

  $ ethos xp rank 0xNowater --json

See code: src/commands/xp/rank.ts

`ethos xp seasons`

List all XP seasons

USAGE
  $ ethos xp seasons [-j] [-v]

FLAGS
  -j, --json     Output as JSON
  -v, --verbose  Show detailed error information

DESCRIPTION
  List all XP seasons

EXAMPLES
  $ ethos xp seasons

  $ ethos xp seasons --json

See code: src/commands/xp/seasons.ts

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

@trust-ethos/cli

Installation

Quick Install (Recommended)

npm

Homebrew

From Source

Updates

Usage

User Commands

XP Commands

Identifier Formats

JSON Output

Shell Completions

Configuration

Exit Codes

Development

Setup

Commands

Project Structure

LLM Agent Integration

Contributing

License

Links

ethos auction active

ethos auction info ID

ethos auction list

ethos autocomplete [SHELL]

ethos broker info ID

ethos broker list

ethos config get

ethos config path

ethos config set VALUE

ethos find QUERY

ethos help [COMMAND]

ethos listing info IDENTIFIER

ethos listing list

ethos listing voters PROJECTID

ethos market featured

ethos market holders IDENTIFIER

ethos market info IDENTIFIER

ethos market list

ethos mi IDENTIFIER

ethos ml

ethos nft list IDENTIFIER

ethos rank IDENTIFIER

ethos review info ID

ethos review list IDENTIFIER

ethos review votes ID

ethos ri ID

ethos rl IDENTIFIER

ethos score status IDENTIFIER

ethos skill install

ethos slash info ID

ethos slash list

ethos slash votes ID

ethos u IDENTIFIER

ethos ui IDENTIFIER

ethos update

ethos us IDENTIFIER

ethos user activity IDENTIFIER

ethos user info IDENTIFIER

ethos user invitations IDENTIFIER

ethos user search QUERY

ethos user summary IDENTIFIER

ethos validator info TOKENID

ethos validator list

ethos validator sales

ethos vi ID

ethos vl [IDENTIFIER]

ethos vouch info ID

ethos vouch list [IDENTIFIER]

ethos vouch mutual TARGET VIEWER

ethos vouch votes ID

ethos xp rank IDENTIFIER

`ethos auction active`

`ethos auction info ID`

`ethos auction list`

`ethos autocomplete [SHELL]`

`ethos broker info ID`

`ethos broker list`

`ethos config get`

`ethos config path`

`ethos config set VALUE`

`ethos find QUERY`

`ethos help [COMMAND]`

`ethos listing info IDENTIFIER`

`ethos listing list`

`ethos listing voters PROJECTID`

`ethos market featured`

`ethos market holders IDENTIFIER`

`ethos market info IDENTIFIER`

`ethos market list`

`ethos mi IDENTIFIER`

`ethos ml`

`ethos nft list IDENTIFIER`

`ethos rank IDENTIFIER`

`ethos review info ID`

`ethos review list IDENTIFIER`

`ethos review votes ID`

`ethos ri ID`

`ethos rl IDENTIFIER`

`ethos score status IDENTIFIER`

`ethos skill install`

`ethos slash info ID`

`ethos slash list`

`ethos slash votes ID`

`ethos u IDENTIFIER`

`ethos ui IDENTIFIER`

`ethos update`

`ethos us IDENTIFIER`

`ethos user activity IDENTIFIER`

`ethos user info IDENTIFIER`

`ethos user invitations IDENTIFIER`

`ethos user search QUERY`

`ethos user summary IDENTIFIER`

`ethos validator info TOKENID`

`ethos validator list`

`ethos validator sales`

`ethos vi ID`

`ethos vl [IDENTIFIER]`

`ethos vouch info ID`

`ethos vouch list [IDENTIFIER]`

`ethos vouch mutual TARGET VIEWER`

`ethos vouch votes ID`

`ethos xp rank IDENTIFIER`

`ethos xp seasons`