Installation

npm install -g hunt.town-cli

Quick Start

# List all projects
ht projects

# Get project details
ht project ONCHAT

# Show co-op statistics
ht stats

# View top projects
ht leaderboard

# Check recent updates
ht updates

Commands

Read-only Commands (No setup required)

ht projects

List all Hunt Town Co-op projects with their HUNT reserves and update counts.

ht projects

Hunt Town Co-op Projects
========================

 #  Symbol     Reserve (HUNT)    Updates
--- --------   ---------------   -------
 1  MT         2,950,608.66137   12
 2  HEPE       163,619.48388     8  
 3  ONCHAT     123,827.44984     15
...

Total: 21 projects | 3,583,506 HUNT locked

ht stats

Display Hunt Town Co-op overview and statistics.

ht stats

Hunt Town Co-op Stats
=====================

HUNT Price:         $0.000136
Total Projects:     21
HUNT in Co-op:      3,583,506 HUNT ($487.36)
Daily Reward Pool:  15,000 HUNT
Current Day:        77

Today's Activity:
  Voting Points:    12,345 given / 10,234 spent
  Votes:            89
  Claims:           23
  HUNT Claimed:     45,678

ht leaderboard [--limit <n>]

Show top projects by Total Value Locked (TVL).

ht leaderboard --limit 5

ht top-voted [--period <period>] [--limit <n>]

Show top voted projects by on-chain voting activity. Fetches Voted events from the Mintpad contract.

ht top-voted                    # Today's top voted (default)
ht top-voted --period week      # This week (needs fast RPC)
ht top-voted --period month     # This month (needs fast RPC)
ht top-voted -n 10              # Top 10 only

Today's Top Voted Projects
========================================

 #  Symbol          Votes   Backers   Reserve (HUNT)         USD
--- ----------   --------   -------   ----------------   -----------
 1  SIGNET        873,473    50,100             83,561     $8,435.78
 2  H1            418,914        22              9,359       $944.87
 3  DR            280,025        34             51,468     $5,195.88
...

Period: Today | Total votes: 1,868,590 | Unique backers: 50,209

Note: week and month periods scan many blocks and may be slow on free public RPCs. Set RPC_URL to a dedicated endpoint for best performance.

ht project <symbol> [--votes]

Show detailed information for a specific project. Add --votes to include voting stats.

ht project H1 --votes

H1 — Hunt Town Co-op
========================
...
Voting Stats:
────────────────────────────────────────
  Today:    117,905 votes from 12 backers
  30 Days:  3,586,140 votes from 444 backers (API)
  Today Rank: #1 of 15 voted projects

ht updates [--project <symbol>]

Show recent project updates. Filter by project or show all.

ht updates --project ONCHAT  # Updates for specific project
ht updates                   # All recent updates

ht wallet

Display your wallet address and HUNT balance (requires private key setup).

ht wallet

Write Commands (Requires Private Key)

ht post-update <symbol> <link>

Post a builder update for a project. This burns HUNT tokens.

ht post-update ONCHAT https://github.com/username/project/releases/v1.2.0

Configuration

For write operations and wallet features, create a configuration file:

~/.hunttown/.env

# Required for write operations
PRIVATE_KEY=your_wallet_private_key_here

# Optional: Custom RPC endpoint (defaults to https://mainnet.base.org)
RPC_URL=https://your-custom-base-rpc.com

You can also use a local .env file in your project directory.

Data Sources

The CLI aggregates data from:

• Mint Club API — Project metadata, reserves, pricing
• Base Chain — Real-time smart contract data (future)
• 1inch Price Feed — HUNT token pricing (future)

Examples

# Monitor your favorite projects
ht project MT
ht project HEPE
ht project ONCHAT

# Check co-op health
ht stats
ht leaderboard

# See what builders are shipping
ht updates

# Post your own update (burns HUNT)
ht post-update MYCOIN https://twitter.com/username/status/123456789

Error Handling

The CLI provides clear error messages:

$ ht project NOTFOUND
Project "NOTFOUND" not found.

$ ht post-update ONCHAT invalidurl
Invalid URL format. Please provide a valid HTTP/HTTPS URL.

$ ht post-update ONCHAT https://example.com
Private key required for this operation.
Set PRIVATE_KEY in ~/.hunttown/.env or local .env file.

Development

# Clone and build
git clone https://github.com/hunt-town/hunt.town-ai
cd hunt.town-ai/cli
npm install
npm run build

# Test locally
./dist/index.js --help

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Hunt Town — Building the future of cooperative work, one HUNT at a time. 🏛️

• Website: hunt.town
• Discord: Join the Co-op
• Twitter: @hunt_town