niffler

Niffler — Claude Code Plugin

Search your X/Twitter knowledge graph — a curated public brain of AI/tech tweets plus your own personal brain of saved posts — right from Claude Code.

What is this?

Niffler lets you save interesting tweets (tools, papers, projects, ideas from X/Twitter), auto-tags and categorizes them, and makes them searchable as a personal AI knowledge graph. This repository is the Claude Code plugin for Niffler: it wires the Niffler hosted service into Claude Code as an MCP server plus a /niffler slash command, so you can search and ask questions against the brain without leaving your editor.

The plugin is a thin client — it does not contain the Niffler backend. It connects to the hosted Niffler service at goniffler.com over MCP (SSE transport). The backend is open source and self-hostable at komalboyo/niffler-opensource.

Install

/plugin marketplace add komalboyo/niffler-plugin
/plugin install niffler

Two Brains

The plugin gives you access to two brains through a single install.

The Public Brain (default)

A curated collection of AI/tech tweets. No sign-in needed — it works immediately. All /niffler commands hit the public brain unless you say "my".

/niffler                       # welcome + command overview
/niffler search AI agents      # find tweets about something
/niffler ask what's the best framework for agents?
/niffler tags                  # see available topics
/niffler stats                 # how big the brain is

Your Personal Brain

Your own saved tweets. Prefix any command with my to query it. The first time you use it, your browser opens to sign in at goniffler.com — after that it stays connected.

/niffler my search transformer architecture
/niffler my ask what tools were recommended for RAG?
/niffler my tags

Save tweets via the Chrome extension or at goniffler.com — they're auto-tagged and instantly available here, no sync step needed.

How It Works

1. Install the plugin (two commands above).
2. Save tweets via the Chrome extension or goniffler.com — AI auto-tags them.
3. Query from Claude Code — search, ask questions, browse by tags, against either brain.
4. New tweets you save show up immediately — the plugin reads live from the hosted service.

Your X account stays safe. Niffler doesn't call Twitter's internal APIs or use your session cookies for automated requests. The Chrome extension reads the page you're already on. The server uses Twitter's official oEmbed API. No ban risk.

Tools

The plugin registers two MCP servers (see plugins/niffler/.mcp.json):

• niffler → https://goniffler.com/mcp/sse — your personal brain (requires sign-in)
• niffler-public → https://goniffler.com/mcp/public/sse — the public brain (no sign-in)

Each exposes the same toolset:

Tool	What it does
niffler_search	Full-text search over saved tweets
niffler_ask	Ask a question, get an answer synthesized from matching content
niffler_list_by_tag	Browse posts by tag
niffler_tags	List all tags in the brain
niffler_get_post	Full details for a single post
niffler_stats	Overview / size of the brain

The /niffler slash command (defined in plugins/niffler/skills/niffler/SKILL.md) maps your natural-language input to these tools and defaults to the public brain. It also integrates with gstack skills, suggesting relevant ones (e.g. /qa, /design-review, /investigate) based on what your search results surface.

Repository Layout

.claude-plugin/marketplace.json        # marketplace entry so Claude Code can discover the plugin
plugins/niffler/
  .claude-plugin/plugin.json           # plugin manifest (name, version, author)
  .mcp.json                            # MCP server config — public + personal SSE endpoints
  skills/niffler/SKILL.md              # the /niffler slash command behavior

Status

Active — early release (v0.1.0). Last commit March 2026.

• The plugin is functional and installable via the Claude Code marketplace. Recent work added the public brain as the default, the gstack skill integration, a friendlier welcome message, and the account-safety note.
• It is a read-only client: save/connect actions were intentionally removed; saving tweets happens through the Chrome extension or goniffler.com, not from Claude Code.
• It depends on the hosted service at goniffler.com being available. There is no test suite or CI in this repo — it's configuration plus a skill definition.
• Version is still 0.1.0; the API surface and command syntax may evolve.

Links

• goniffler.com — hosted service + Chrome extension
• komalboyo/niffler-opensource — self-host your own instance