gitwtfhub

wtf is briefing-loop?

randyhaddad/briefing-loop — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

An AI agent plugin that builds a daily personalized reading digest across articles, podcasts, and videos, learning your taste over time and delivering to Kindle, email, Slack, or chat.

Mindmap

mindmap
  root((Briefing Loop))
    Content Types
      Articles newsletters
      Papers YouTube
      Podcasts X posts
    Learning
      Read save reject
      Explore exploit mix
      Inspectable profile
    Delivery
      Kindle email
      Slack chat
      PDF EPUB files
    Install
      Claude Code plugin
      Codex plugin
      Generic skills

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Get a daily reading digest curated to your interests delivered to your Kindle or email without manually finding articles.

REASON 2

Let the agent learn your reading preferences by tracking what you save, reject, and engage with over time.

REASON 3

Send specific approved articles directly to your Kindle device from your AI agent.

What's in the stack?

PythonClaude CodeCodex

How it stacks up

randyhaddad/briefing-loopa-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/53/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires a Claude Code or Codex agent environment, Kindle delivery requires configuring a Kindle email address.

MIT license, use, modify, and distribute freely for any purpose including commercial use.

Wtf does this do

Briefing Loop is a plugin for AI coding agents (Claude Code, Codex, and others) that builds a personalized daily reading digest. You tell it which articles, newsletters, papers, podcasts, or YouTube videos to include, and it learns your preferences over time based on what you read, save, reject, or ask about. The selection logic is described as similar to how a music streaming service balances familiar recommendations with occasional surprises. Most of what it delivers matches your established taste, but a small portion is intentionally outside your usual areas to help it learn what else you might like. The digest can be delivered to several destinations: a chat interface, email, Slack, a PDF or EPUB file, or directly to a Kindle device for approved articles. The tool verifies sources, authors, publication dates, and recency before including items. Your preference profile and reading history are stored as files you can inspect and edit directly. Installation works through the Claude Code plugin marketplace using three commands, or as a Codex plugin via a manifest file in the repository, or as a generic skill folder for any agent harness that supports that format. After installation, you prompt your agent to set up the digest and provide it with links to start building your initial profile. Personal data such as delivery addresses, credentials, and reading history should not be committed to version control. The project is MIT licensed.

Yoink these prompts

Prompt 1
How do I install briefing-loop in Claude Code and set up my initial reading profile with a few seed links?
Prompt 2
How does briefing-loop balance showing familiar content versus new topics to learn my reading preferences?
Prompt 3
How do I configure briefing-loop to send my daily digest to my Kindle email address?

Frequently asked questions

wtf is briefing-loop?

An AI agent plugin that builds a daily personalized reading digest across articles, podcasts, and videos, learning your taste over time and delivering to Kindle, email, Slack, or chat.

What language is briefing-loop written in?

Mainly Python. The stack also includes Python, Claude Code, Codex.

What license does briefing-loop use?

MIT license, use, modify, and distribute freely for any purpose including commercial use.

How hard is briefing-loop to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is briefing-loop for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.