mt-signals

CLI for MetalTorque Research Signals — scored trend intelligence from HN, Reddit, ArXiv, and GitHub.

Install

npx mt-signals signals                   # Run without installing
npm i -g mt-signals                      # Or install globally

Quick Start

# List all scored signals
mt-signals signals

# Top 5 hottest signals
mt-signals top 5

# Breakout trends + hot signals (score 6+)
mt-signals trending

# Deep dive on a topic
mt-signals lookup "MCP server"

# Filter by category
mt-signals signals --category=ai

Commands

Discovery

| Command | Description | |---------|-------------| | signals | List all scored signals (filterable by category, sort, min score) | | top [N] | Top N signals ranked by score (default: 10) | | trending | Breakout signals (1.8x+ rolling avg) and hot signals (score 6+) |

Analysis

| Command | Description | |---------|-------------| | lookup <topic> | Deep dive — score breakdown, evidence, trend history, actionable-for audience | | category <name> | All signals in a category (ai, infrastructure, security, devtools, data, business, career, market) | | stats | Aggregate stats — total signals, category breakdown, top 10 |

Management

| Command | Description | |---------|-------------| | recalculate | Force score recalculation (applies time decay, detects new breakouts) | | config | View current configuration | | config set <key> <value> | Set config value (keys: url, apiKey) |

Agent / CI Usage

Every command supports --json:

# JSON output for scripting
mt-signals top 10 --json | jq '.[0].topic'

# Pipe trending breakouts to another tool
mt-signals trending --json | jq '.breakouts'

# Filter high-score AI signals
mt-signals signals --category=ai --min=7 --json

Options

| Flag | Description | |------|-------------| | --json | Output raw JSON (for piping/agents) | | --category=X | Filter: ai, infrastructure, security, devtools, data, business, career, market | | --sort=X | Sort: score, urgency, buyer_intent, durability | | --min=N | Minimum score filter | | --limit=N | Max results | | --version | Print version |

Environment Variables

| Variable | Description | |----------|-------------| | MT_SIGNALS_API_KEY | Access key for the API (overrides saved config) | | MT_SIGNALS_URL | Server URL (default: https://signals.metaltorque.dev) | | NO_COLOR | Disable colored output |

Configuration is stored in ~/.mt-signals/config.json.