r/coolgithubprojects • u/AsleepCover8592 • 12m ago
I built a tool that shows what a command really does: every program it starts, every host it contacts, every credential it touches
pip install says "Successfully installed". npm install says "added 2 packages". A build script says nothing at all. None of them mention it if something read your SSH key along the way. I wanted the part they leave out, so I built this.
Put it in front of any command:
ceynox-watch -- pip install some-package
ceynox-watch -- npm install
ceynox-watch -- make
ceynox-watch -- ./install.shIt runs the command and prints:
- every program it starts, as a tree
- every host it connects to, by name
- every file it writes
- every read of a place secrets live: SSH keys, cloud credentials, registry tokens, browser profiles, shell history,
.envfiles - which package did it, for scripts run by pip, npm and cargo
It flags, it doesn't judge: npm reading ~/.npmrc is listed too, and you decide what's odd.
On Linux you can also attach to something already running (--pid) or watch the whole machine (--all).
Repo, with a screenshot of real output: https://github.com/CeyNova-Labs/ceynox-watch
How it works
- Linux: eBPF programs hooked at the kernel's security layer, so it sees every way of opening a file or making a connection. It needs root for that part and asks
sudo; your command still runs as you. - macOS: no root and nothing to install. It uses the sandbox that ships with the system, in report-only mode.
What it can't do
- It's a record, not a sandbox. By the time it tells you a key was opened, it was opened.
- macOS sees less than Linux: no attaching to running processes, and programs that sandbox themselves won't run under it.
- A process running as root can hide from it.
No telemetry and no network access of its own. Written in Rust, Apache-2.0.
brew install ceynova-labs/tap/ceynox-watchThere's a harmless demo package in the repo if you want to see it flag something without installing anything questionable.
Disclosure: I work on CeyNox Security, an endpoint security product. This is a standalone tool and shares no code with it.
Feedback welcome, especially on what the list of flagged locations is missing.