The AgentEye collector is a small, per-machine daemon that ships your local coding-agent sessions — OpenAI Codex (CLI, IDE, and desktop), OpenClaw, and Hermes — to your AgentEye deployment. This repository hosts the installer and the release binaries.
curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh | shOr set it up as a background service in one step by passing your AgentEye ingest URL and an
events:add API key:
curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
| sh -s -- --url https://ingest.example.com/events --key sk-… --codex-enabledThe installer detects your OS/arch, verifies the binary's SHA-256 checksum, installs it on your
PATH, and (when given a URL + key) installs a systemd (Linux) or launchd (macOS) service.
Turn on session capture per agent with --codex-enabled, --openclaw-enabled, and/or
--hermes-enabled (each off by default) — combine as many as you run.
It installs the current stable release. Pass --beta for the pre-release channel, or
--version <X> to pin an exact version. While no stable release has been promoted yet, the
installer falls back to the current beta and tells you so.
agenteye-collector update # move to the current stable release
agenteye-collector update --beta # track pre-releases
agenteye-collector update --check # report only; install nothingThe collector downloads the new binary, verifies its checksum, runs it once to confirm it works, swaps it in atomically, and restarts the managed service. A corrupt or wrong-architecture download aborts the update and leaves the running binary untouched.
If the binary is in /usr/local/bin you will need sudo agenteye-collector update; installs under
~/.local/bin need no elevation.
stable and beta. A channel is a pointer to a published release, and it only ever moves forward
— tracking beta will not walk you back to an older stable build. Which release each channel serves
is published at versions.json; if stable is null, nothing has been promoted
to it yet and update will point you at --beta.
agenteye-collector update --version 0.0.1-beta.17 # install exactly this, up or down
agenteye-collector update --rollback # restore the previous binaryEvery update keeps the binary it replaced as agenteye-collector.bak beside the new one, which is
what --rollback restores.
Self-update does not apply on Windows (a running .exe cannot be replaced in place — download
the new one and restart the task) or inside a container (pull a newer image tag instead).
agenteye-collector healthLinux and macOS (x86_64 and arm64). Windows binaries are attached to each release for manual use;
the curl | sh installer and the managed service cover Linux and macOS.
Binaries and their SHA256SUMS are published on the Releases page.
MIT — see LICENSE.