phtui: Skill for Claude Code

phtui Idea Pocket

Overview

phtui is a Product Hunt-powered idea pocket for agents building new services.

Use the CLI first. MCP is available, but CLI JSON output is usually cheaper in tokens because the agent can request a narrow command, inspect only the fields it needs, and avoid loading a broad MCP tool context.

Install

If phtui is already installed:

phtui help

Install latest from Go:

go install github.com/qyinm/phtui@latest

Or run from a checked-out repo:

go run . help

Core Workflow

1. Start broad with ideas.
2. Pick 1-3 products that match the user's product direction.
3. Fetch details only for those selected products.
4. Summarize concrete reusable patterns: target user, core workflow, pricing clue, feature hook, and possible MVP angle.
5. Do not paste full raw JSON unless the user asks. Extract only the relevant signals.

Commands

Category inspiration

Use this when the user has a domain, category, or product area.

phtui ideas --category ai-agents --limit 5

From source checkout:

go run . ideas --category ai-agents --limit 5

Expected JSON shape:

{
  "source": "category",
  "category_slug": "ai-agents",
  "total": 5,
  "items": [
    {
      "product": {
        "slug": "example",
        "name": "Example",
        "tagline": "Short positioning",
        "votes": 123,
        "comments": 8,
        "rank": 1,
        "categories": ["AI Agents"]
      },
      "inspiration_reason": "...",
      "feature_signals": ["..."],
      "market_signals": ["..."]
    }
  ]
}

Leaderboard inspiration

Use this when the user asks what is currently popular or wants broad market scanning.

phtui ideas --period daily --limit 5
phtui ideas --period weekly --limit 10
phtui ideas --period monthly --date 2026-05-01 --limit 10

Product detail

Use this after selecting a product slug from ideas or leaderboard.

phtui detail <product-slug>