---
name: Manage Alerts
slug: manage-alerts
category: Automation
description: Manage Alerts lets you list, add, or remove your AlphaAI ticker news-alert subscriptions. Use it when you want to see current alerts, subscribe to a ticker, or stop alerts for one; it requires a paid Basic or Pro plan.
github: "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/alphai/skills/manage-alerts"
language: JavaScript
stars: 922
forks: 392
install: "npx degit https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/alphai/skills/manage-alerts ~/.claude/skills/manage-alerts"
installs_to: ~/.claude/skills/manage-alerts
source_path: plugins/alphai/skills/manage-alerts/SKILL.md
collection_size: 25
category_size: 1523
collection_url: "https://dirskills.com/collections/ccplugins/awesome-claude-code-plugins"
added: 2026-08-22T05:20:42.123Z
last_synced: 2026-08-22T05:20:42.123Z
canonical_url: "https://dirskills.com/skills/manage-alerts"
---

# Manage Alerts

Manage Alerts lets you list, add, or remove your AlphaAI ticker news-alert subscriptions. Use it when you want to see current alerts, subscribe to a ticker, or stop alerts for one; it requires a paid Basic or Pro plan.

**Install:**

```bash
npx degit https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/alphai/skills/manage-alerts ~/.claude/skills/manage-alerts
```

## README

# Manage alerts

Let the user manage their own AlphaAI ticker news-alert subscriptions from the
chat. Identity comes from the OAuth login — these tools act on the **caller's
own** account.

> **Tier-gated.** `alphai_alerts_*` require a **Basic or Pro** plan. On the Free
> tier they return `tier_not_paid` — relay that and point to
> <https://alphai.io/pricing> instead of retrying.

## Steps

1. **Show current state first.** For any add/remove, call `alphai_alerts_list()`
   up front so you (and the user) can see existing subscriptions, the per-alert
   filters, and the tier limit (`current` / `limit`).
2. **Subscribe / update.** `alphai_alerts_subscribe(ticker, category_filter?,
   min_relevance_score?)`.
   - This is a **partial update**: omitting a field on an *existing* subscription
     preserves its current value. A brand-new subscription defaults
     `min_relevance_score` to 6.
   - `category_filter` is an optional whitelist from the 14 categories (e.g.
     `["earnings", "insider"]`) — only those categories trigger the alert.
   - Confirm the ticker is real first if unsure (`alphai_tickers`); the tool
     raises `unknown_ticker` / `limit_reached` otherwise.
3. **Unsubscribe.** `alphai_alerts_unsubscribe(ticker)` — idempotent; returns
   `{removed: false}` if it was already inactive.

## Output

- After a change, restate the resulting subscription in one line: ticker, which
  categories trigger it, and the minimum relevance — so the user sees exactly
  what they'll be alerted on.
- For a list request, render the subscriptions as a short table (ticker ·
  categories · min relevance · delivery mode) and note `current/limit`.

## Guardrails

- **Confirm before mutating.** Read back what you're about to subscribe to or
  remove before calling the write tool, especially for bulk changes.
- Handle errors plainly: `tier_not_paid` → suggest upgrading; `limit_reached` →
  list current alerts so the user can free a slot; `unknown_ticker` → don't guess
  a substitute.
- Never subscribe to tickers the user didn't ask for.