@feed-the-claw/cli
v0.1.4
Published
CLI for Feed the Claw — the gamified distribution habit tracker for builders
Maintainers
Readme
@feed-the-claw/cli
The CLI for Feed the Claw — a gamified distribution habit tracker for builders.
Raise a virtual claw by consistently sharing your work across the internet. Track streaks, earn XP, level up, and watch your claw evolve through life stages.
Quick Start
npx @feed-the-claw/cliNo signup required — an anonymous account is created automatically on first run.
Commands
Core
claw status # Claw state, hunger, streak, XP (default)
claw feed <url> # Broadcast a link (+10 XP)
claw engage # Log an engagement signal (+5 XP)
claw ship <url> # Ship log — launched something (+20 XP, 1/day)Progress
claw history [n] # Recent feed events (default: 20)
claw streak # Streak details and shell health
claw report # Weekly distribution reportPower-ups
claw boost [token-id] # Show boost tokens or activate one
claw referral [code] # Get your invite link or redeem a code
claw launch [name] [url] # Activate 48h Launch Day Mode (200 XP cap, 1.5x diversity)Auth
claw login # Sign in with email/password
claw login --google # Sign in with Google (opens browser)
claw login --signup # Create account with email/password
claw login --anonymous # Create fresh anonymous account
claw logout # Clear saved credentials
claw whoami # Show current user infoConfig
claw config api-url # Show current API URL
claw config api-url <url> # Set custom API URLBy default, the CLI uses the production API:
https://api.feedtheclaw.com/api/v1Fun
claw tip # Random lobster wisdomHow It Works
- Feed your claw by sharing links to where you distributed your work (tweets, HN posts, blog articles, etc.)
- Earn XP for each signal — more platforms = diversity bonus
- Maintain streaks by feeding daily — miss a day and your shell cracks
- Level up and evolve through life stages: Larva → Juvenile → Adult → Elder → Ancient
- Compete on the leaderboard and invite friends for boost tokens
Config Directory
Credentials and settings are stored in ~/.config/feed-the-claw/.
Links
- Web app: feedtheclaw.com
- Issues: github.com/apwn/Feed-The-Claw/issues
