gitwtfhub

wtf is ltm?

agent-hellboy/ltm — explained in plain English

Analysis updated 2026-05-18

23GoAudience · ops devopsComplexity · 4/5Setup · moderate

TL;DR

A Linux tool that records process, file, network, and memory activity via eBPF, so you can later query a timeline of what happened on your machine.

Mindmap

mindmap
  root((repo))
    What it does
      Records machine history
      Uses eBPF tracepoints
      Stores events in SQLite
    Tech stack
      Go
      eBPF
      SQLite
    Use cases
      Debug past incidents
      Diff machine state
      Ask plain English questions
    Audience
      Developers
      Sysadmins

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

Investigate which process modified a specific file after the fact.

REASON 2

See what changed on a Linux machine between two points in time.

REASON 3

Ask plain English questions about system activity and get a timeline answer.

REASON 4

Audit network connections and disk activity without adding logging to apps.

What's in the stack?

GoeBPFSQLiteLinux

How it stacks up

agent-hellboy/ltm0x4d31/stingeremmayusufu/tessera
Stars232323
LanguageGoGoGo
Setup difficultymoderatemoderatemoderate
Complexity4/54/54/5
Audienceops devopsdeveloperops devops

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Recording needs root or specific capabilities and only works on x86_64 Linux.

No license information is stated in the README.

Wtf does this do

ltm is a tool for Linux that keeps a searchable history of what happened on your machine, so you can go back later and figure out what a process, file, or network connection did and when. Think of it as a black box recorder for your computer: it quietly watches activity in the background, then lets you ask questions about the past instead of guessing. Under the hood it uses a Linux kernel feature called eBPF to record around sixty different kinds of system events: processes starting and stopping, files being opened, read, written, renamed, or deleted, memory being mapped, network sockets connecting or listening, and disk activity. All of this is saved as metadata, not actual file contents, into a local SQLite database. Once you have started recording, you can explore the results several ways. A timeline command lets you filter events by process, user, file path, program name, or time window. A watch command tails events live, similar to following a log file. A diff command shows what changed on the machine between two points in time. There is also a plain English query mode, where you can ask something like which process wrote to files the most today, and ltm either matches it to a built in template or, if you configure an AI agent such as Claude or Codex, translates it into a safe, read only SQL query for you. Recording requires root access or specific Linux capabilities and only works on 64 bit Intel and AMD machines. Querying the recorded data does not need root, and if you do not have a live recording set up, a benchmark command can generate fake sample events so you can try out the timeline and query features anyway. The project currently only decodes IPv4 network addresses, and some byte counts and file descriptor mappings can be approximate under heavy load. It is written in Go and is aimed at developers and system administrators who want to debug or audit what actually happened on a Linux machine.

Yoink these prompts

Prompt 1
Walk me through building ltm and starting a recording session on Linux.
Prompt 2
Show me how to use ltm's timeline command to filter events by process and time.
Prompt 3
Explain how ltm turns a plain English question into a safe read only SQL query.
Prompt 4
Help me set up ltm's benchmark mode to try it out without a live Linux recorder.

Frequently asked questions

wtf is ltm?

A Linux tool that records process, file, network, and memory activity via eBPF, so you can later query a timeline of what happened on your machine.

What language is ltm written in?

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

What license does ltm use?

No license information is stated in the README.

How hard is ltm to set up?

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

Who is ltm for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

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