Repository navigation
Hodometer 1.3.0 makes the socket fit for many AI agents working at once, and adds the Sentinel daemon: the non-AI part of the defense that SENTINEL.md describes.
What's new
- Commands run in parallel. Four worker threads serve the socket. Each client's commands still run one at a time and reply in the order sent, but a slow
inspectfrom one client no longer holds up the others. Up to 128 commands can wait across all clients; past that a client getscommand queue full, try again. - Four captures at once, one per process (or one for every process).
capture stop <pid>ends one,capture stopends all, andcapturelists them incaptures[]. Thecaptureevent carriesactive. Each Inspector shows its own process's capture. connspages and filters:conns [pid|all] [active] [since <now>] [cursor <n>] [limit <n>], withtotal,count,nextandnowin the reply, so a poller can read every flow, or only what changed since its last poll.- Lighter packet streams.
watch <pid> handshakessends only the frames that decode to TLS or QUIC hellos, DNS or HTTP. A newflowinfoevent announces a flow's SNI, ALPN, HTTP request or TLS version as soon as it is decoded, withoutpackets. - 64 watched processes per connection (was 8).
inspectreports the executable's SHA-256, and signature checks are cached per path and hash.statusreportscaptures,max_captures,max_watchandworkers.- Sentinel daemon (
sentinel/in the source; Python, not part of the download). It owns the Hodometer connections, scores every process with the rubric inSENTINEL.md, starts an evidence capture at SUSPECT, and runs the Sentinel coordinator and up to four investigators on the Claude API. It runs from its own private Python copy, so allowing it does not trust every Python script on the machine, and it is dry-run by default: kills and blocks are logged, not sent. Seesentinel/README.md. It has been run live against Hodometer without models; the run with models has not been tested yet. build.ps1 -Out <name>builds under another name whileHodometer.exeis running.
Install
- Download
Hodometer.exeandinstall.ps1into the same folder. - Run
install.ps1from an elevated PowerShell. It registers the Hodometer logon task (elevated, no UAC prompt), adds a Desktop shortcut that starts that task, and starts the app.
Upgrading from 1.2.0: exit Hodometer from the tray menu, replace Hodometer.exe, and start it again. The logon task and your trusted and blocked lists are kept. install.ps1 is unchanged since 1.1.0. The socket protocol is backward compatible.
Build
Hodometer.exe was built from this tag with build.ps1 (MinGW-w64, static). It is not code-signed, so Windows SmartScreen may warn on first run.
SHA-256 c5fe6135050562749df3c5a0dc8aa27f315bbe27e3da6e57d3ecadfed4de28fc