gitwtfhub

wtf is sigwire?

yeet-src/sigwire — explained in plain English

Analysis updated 2026-05-18

147JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Linux terminal dashboard that streams every process signal on the machine live, showing sender, target, and how each one was handled.

Mindmap

mindmap
  root((sigwire))
    What it does
      Streams live process signals
      Shows sender and target
      Tracks handler timing
    Tech stack
      JavaScript
      eBPF
      Linux kernel tracepoints
    Use cases
      Debug crashes
      Trace shutdown signals
      Inspect interrupted syscalls
    Audience
      Backend developers
      Systems engineers
    Controls
      Pause and inspect
      Filter by signal
      Color coded severity

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

Watch which process is sending SIGTERM or SIGKILL to another process during a shutdown.

REASON 2

Debug a mysterious failed read or network call caused by a signal interrupting it.

REASON 3

See how long a program's signal handler takes to run.

REASON 4

Spot a process being crashed by SIGSEGV and trace exactly what raised it.

What's in the stack?

JavaScripteBPFLinux

How it stacks up

yeet-src/sigwirefrank-masciopinto/no-kingshaleclipse/cscience
Stars147146148
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderate
Complexity3/53/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 5min

Linux only, requires installing the yeet daemon to load the eBPF program.

Dual licensed under BSD and GPL, you can choose which terms to use it under.

Wtf does this do

sigwire is a Linux terminal tool that shows you every signal being sent between processes on your machine, live, as it happens. In Unix systems, processes communicate short interrupts called signals, things like SIGINT when you press Ctrl-C, SIGTERM when something is asked to shut down, or SIGSEGV when a program crashes. Normally these are invisible unless you are the developer of the specific program involved. sigwire watches all of them across the whole machine at once, similar to how the command tail follows a growing log file. It works by hooking into low level kernel tracepoints rather than attaching to any single process, so it can see traffic from your own applications, background services, and the kernel's own crash handling, all without those programs knowing they are being watched. Each signal is shown as a line describing who sent it, who received it, which signal it was, how it was raised, whether the receiving program had special code to catch and handle it, how long that handler took to run, and whether the signal interrupted something the receiving program was waiting on. The terminal interface is interactive. You can pause the live feed and select a row to see full details, filter signals by typing part of a process name or signal name, filter down to only signals that interrupted a paused operation, or choose which signals to show or hide. Signals are color coded by how serious they are, from routine housekeeping signals to ones that kill a process outright. Getting started is a single install command followed by one command to launch the dashboard, and it works immediately since signals are constant background activity on any running machine. It only runs on Linux and is aimed at engineers debugging process behavior, timing issues, or unexpected crashes. It is dual licensed under BSD and GPL terms.

Yoink these prompts

Prompt 1
Help me install and run sigwire on my Linux machine to watch live process signals.
Prompt 2
Explain what an EINTR interruption shown in sigwire means for my running program.
Prompt 3
Show me how to filter sigwire's live feed to only interrupted syscalls.
Prompt 4
Walk me through inspecting a single signal's detail panel in sigwire.

Frequently asked questions

wtf is sigwire?

A Linux terminal dashboard that streams every process signal on the machine live, showing sender, target, and how each one was handled.

What language is sigwire written in?

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

What license does sigwire use?

Dual licensed under BSD and GPL, you can choose which terms to use it under.

How hard is sigwire to set up?

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

Who is sigwire for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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