🎒 Bags Hunter

Mode: bags-hunter · Category: Crypto / Solana Memecoins

Solana memecoin specialist for the Bags.fm launchpad. Read-only research, 0-100 scoring, multi-source rug checking, and portfolio review.

🔒 Bags Hunter never asks for wallet private keys, seed phrases, or passwords. Every tool uses only public APIs and public on-chain data. The agent cannot execute trades or move funds.

Quick run

From the repo root, after pnpm -r build:

node apps/cli/dist/index.js -a bags-hunter -q "What's trending on Bags.fm right now?"

Requirements

LLM provider

Recommended: Anthropic Claude for nuanced risk explanations, Groq for fast iteration.

• ANTHROPIC_API_KEY (or any other LLM provider key)
• HELIUS_API_KEY — optional but recommended (enables holder distribution + creator analysis)

Plugins used

bagsfm (10 tools), solana, whale, security

Skills bundled

• bags-hunter:scan-and-score — discovery flow (trending → score → filter → present)
• bags-hunter:rug-check-deep — 4-stage rug heuristic (liquidity, authority, holders, creator)
• bags-hunter:portfolio-review — basket analysis with rebalancing suggestions

The 10 Bags.fm tools

Example sessions

Discovery — what's hot right now

node apps/cli/dist/index.js -a bags-hunter -q "What's trending on Bags.fm in the last 6 hours? Show top 5 with scores."

Agent runs bags_trending, applies first-pass filter, then bags_token_analysis on the survivors. Returns top 5 with scores, liquidity, buy/sell ratios, and risk flags.

Vet a specific token

node apps/cli/dist/index.js -a bags-hunter -q "Vet this Bags.fm token: 7xKXtg2CW87d3a4...y3 — should I be worried?"

Agent runs the full rug-check-deep flow: liquidity health, mint/freeze authority, holder concentration, creator history. Returns a structured verdict.

Compare alternatives

node apps/cli/dist/index.js -a bags-hunter -q "Compare these 3 Bags tokens for me: AAA111, BBB222, CCC333. Which has the best fundamentals?"

Uses bags_compare for the side-by-side composite score, then a quick rug check on the winner.

Portfolio review

node apps/cli/dist/index.js -a bags-hunter -q "Review my Bags.fm basket: contracts AAA, BBB, CCC, DDD, EEE. Any rebalancing suggestions?"

Runs bags_portfolio_score + targeted rug checks on positions over 10% allocation. Reports diversification status and suggests trims for over-concentrated positions.

Watching for entry/exit signals

node apps/cli/dist/index.js -a bags-hunter -q "Analyze volume patterns for contract XYZ — any buy or sell signals?"

Uses bags_volume_pattern to detect 5m bursts, cooling, accumulation, or distribution patterns.

Scheduled mode (optional)

Bags Hunter ships with a heartbeat checklist in .agents/bags-hunter/HEARTBEAT.md. Default schedule: daily at 9 AM. Disabled by default.

To enable a daily Bags.fm scan delivered to Telegram:

# Edit .agents/bags-hunter/HEARTBEAT.md and set "enabled: true"

# Then register the cron job:
node apps/cli/dist/index.js cron add hb-bags-hunter \
  --schedule "0 9 * * *" \
  --agent bags-hunter \
  --prompt "Run your heartbeat checklist for {{date}}" \
  --deliver-to "telegram:@me"

What Bags Hunter will NOT do

• Ask for wallet private keys, seed phrases, or passwords (ever)
• Execute trades or move funds
• Promote or shill tokens
• Give financial advice — only data and patterns
• Make absolute predictions about price direction

Files

Agent files at .agents/bags-hunter/:

• SOUL.md — persona and principles
• IDENTITY.md — metadata, model preferences
• USER.md — user context
• TOOLS.md — tool policy
• HEARTBEAT.md — scheduled checklist (opt-in)
• MEMORY.md — long-term memory
• skills/scan-and-score/SKILL.md
• skills/rug-check-deep/SKILL.md
• skills/portfolio-review/SKILL.md

What's next?

• Browse all 17 agents
• Agent format reference
• Crypto plugin overview