explaingit

yeet-src/sqlitefeed

Analysis updated 2026-05-18

9JavaScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

A terminal tool that shows every SQL query any program on your machine runs against SQLite, live, without changing your code.

Mindmap

mindmap
  root((repo))
    What it does
      Live SQL feed
      Traces SQLite calls
      No app changes needed
    Tech stack
      JavaScript
      eBPF
      Linux kernel
    Use cases
      Debug slow queries
      Spot errors live
      Watch many processes
    Audience
      Developers
      Backend engineers

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

What do people build with it?

USE CASE 1

Debug why a SQLite backed app is slow by watching real query latency live.

USE CASE 2

Spot failing or erroring SQL statements without adding any logging code.

USE CASE 3

Monitor several SQLite using processes on one machine at the same time.

USE CASE 4

Learn what a script's database layer is actually doing behind the scenes.

What is it built with?

JavaScripteBPFSQLiteLinuxC

How does it compare?

yeet-src/sqlitefeedabivan-tech/zvec-mcpardupilot/dronecan-webtools
Stars999
LanguageJavaScriptJavaScriptJavaScript
Last pushed2025-09-02
MaintenanceQuiet
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audiencedeveloperdeveloperops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Linux only, requires installing the yeet daemon and building a BPF object first.

Dual licensed under BSD and GPL, so you can choose the permissive BSD terms or the GPL terms depending on your project.

In plain English

sqlitefeed lets you watch, in real time, every SQL statement that any program on your computer sends to SQLite. Think of it like a live camera pointed at your database: instead of digging through logs after something breaks, you see each query as it happens, right in your terminal. It works by attaching directly to the SQLite library itself, not to any single app. That means one run of sqlitefeed can watch your web server, a background job, and someone typing commands into a database shell, all at the same time, without any of them needing to be changed, restarted, or configured to cooperate. This is done using a Linux kernel feature called eBPF, which lets the tool observe running programs safely from outside them. For each query, sqlitefeed shows the actual SQL text with color highlighting, the real values that were plugged into placeholders, how many rows came back, how long the query took to run, and whether it succeeded or failed. Failed queries are marked in red so problems stand out immediately. You can scroll through the feed, pause it, jump back to the newest entry, or filter it with a quick search to find a specific process or query. One clever detail: even if sqlitefeed starts watching after a program has already prepared its queries, it can usually still recover the original SQL text by reading it directly out of the program's memory. This only works on 64 bit Intel and AMD machines, on other systems those older queries simply show up as unknown until they run again. Setup involves installing a small companion program called yeet, then building and running sqlitefeed with a couple of terminal commands. It only works on Linux, since it depends on kernel level tracing that other operating systems do not support. There is no need to change application code, add logging statements, or restart the traced programs. It is aimed at developers who want to understand what their SQLite backed applications are actually doing under the hood, without adding overhead or modifying anything.

Copy-paste prompts

Prompt 1
Walk me through installing the yeet daemon and building sqlitefeed on Linux.
Prompt 2
Explain how sqlitefeed uses eBPF uprobes to trace libsqlite3 without touching my app.
Prompt 3
Help me use sqlitefeed's fuzzy filter to find all queries from one process.
Prompt 4
What does it mean when sqlitefeed shows a statement as unknown, and how does recovery work?

Frequently asked questions

What is sqlitefeed?

A terminal tool that shows every SQL query any program on your machine runs against SQLite, live, without changing your code.

What language is sqlitefeed written in?

Mainly JavaScript. The stack also includes JavaScript, eBPF, SQLite.

What license does sqlitefeed use?

Dual licensed under BSD and GPL, so you can choose the permissive BSD terms or the GPL terms depending on your project.

How hard is sqlitefeed to set up?

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

Who is sqlitefeed for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.