index

Instructions for using SupSub through an AI assistant such as Claude Code or Cursor instead of typing SupSub commands directly. SupSub collects posts from subscribed websites, public accounts, and other sources.

In plain words
What is it for?
Adding subscriptions, checking unread content, summarising and filtering articles, comparing sources, creating briefings, and marking a source as read.
Why use it?
The assistant can carry out subscription tasks and help interpret the collected content through ordinary requests.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/supsub-ai/supsub-cli/index
Clone the repo
git clone --depth 1 https://github.com/SupSub-AI/supsub-cli
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 798 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00798
Opus 5 $0.00000 $0.00399
Sonnet 5 $0.00000 $0.00160
Haiku 4.5 $0.00000 $0.00080

Measured 2d ago against content hash 7be467844cbc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

index scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/agents/index.md · 94 lines

What it actually says

让 AI 助手帮你用

如果你不想记命令,可以把 SupSub 交给 AI 助手(Claude Code、Cursor 这类)。

设置一次之后,你只要用平常说话的方式提要求就行:

帮我订阅「阮一峰的网络日志」

我今天有什么没看的?

把这周关于 AI 的文章挑三篇,各写两句话讲讲说了什么

助手会自己去查、去操作,然后用人话回你。

它比你自己敲命令强在哪

代你操作只是顺带的,真正有用的是它能帮你消化内容

  • 总结 —— 「这篇讲了什么,两句话说完」
  • 筛选 —— 「今天这 40 条里,跟我做的产品有关的挑出来」
  • 对比 —— 「这三篇对同一件事的说法有什么不一样」
  • 汇总成简报 —— 「把我这周所有未读整理成一份摘要,按主题分类」
  • 顺手清理 —— 「我看完了,帮我把这个号标记成读过」

这些都不是 SupSub 本身的功能,是 AI 助手拿到内容之后帮你做的加工。

最省事的设置方式:让助手自己装

把下面这句话直接发给你的 AI 助手,安装、技能包、登录它会一路带你走完(登录时它会给你一个链接,你在浏览器点一下确认即可):

请阅读 https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/docs/cli-installation-guide.md 并据此帮我安装并配置 SupSub CLI

想自己动手的话,按下面手动设置。

怎么设置

需要给助手装一个「技能包」,它才知道该怎么操作 SupSub。选你在用的工具:

Claude Code

在对话框里输入这两行:

/plugin marketplace add SupSub-AI/supsub-cli
/plugin install supsub-cli@supsub

已经装了 supsub 的话

在终端里跑一句就行:

supsub skills sync

其他 AI 助手

Cursor、Codex、Gemini CLI 等同样支持,在终端里跑:

npx -y skills add SupSub-AI/supsub-cli --skill '*' -y

还差一步:登录

技能包装好后,助手需要你的账号才能看到你的订阅。直接跟它说:

帮我登录 supsub

它会给你一个链接,你在浏览器里点一下确认就行——不用在终端里输任何东西。

之后就不用再管了。只有长时间没用过才需要重新登录一次。

想确认是否成功,可以问它「我现在登录的是哪个账号」。

试试第一句话

装完之后,可以从这几句开始:

我订阅了哪些?

我还有什么没读的?

帮我搜一下最近关于 AI 的文章

接下来

::: tip 升级之后 SupSub 更新之后,技能包不会自动跟着更新。如果发现助手开始答非所问,在终端跑一句 supsub skills sync 就能修好。 :::

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 94 lines · 0 tokens per session scan A 7be467844cbc

Subscribe to this mod's changes

index is an agent published in the GitHub repository SupSub-AI/supsub-cli (5 stars, last pushed 1mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 798 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.