-
1
Download the Mac app
Download the disk image for Apple silicon or for Intel from the
latest release
on GitHub, open it and drag Agent Lookout to Applications. It needs macOS 13
Ventura or later, and no Node.js.
The first time you open it, macOS says “Agent Lookout” Not Opened: press Done,
then Open Anyway in System Settings › Privacy & Security. Kept in
Applications, it updates itself from later releases.
-
2
Start it with one command
You need Node.js 22.12 or newer, and Claude Code, Codex or the Antigravity CLI.
npx agent-lookout
The first time, npm asks Ok to proceed? (y): press Enter, and it
downloads under 2 MB. Then it prints
Agent Lookout is running at http://127.0.0.1:4777.
Open that address, and your sessions appear within a few seconds. It listens on
this machine only and runs until you press Ctrl+C. --port picks
another port, and --open opens the page in your browser. To update,
run npx agent-lookout@latest.
-
3
Let your coding agent start it
Paste the prompt in the README’s
Install with your agent
into Claude Code, Codex or another coding agent. It checks your Node.js, starts
Agent Lookout with npx and checks that it answers. When the agent’s session ends,
Agent Lookout can stop with it. If the page then says it has stopped updating, run
npx agent-lookout yourself.
-
4
Run it from the repository
Run it this way to read or change its code. It needs the same Node.js.
git clone https://github.com/Olanetsoft/agent-lookout.git
cd agent-lookout
npm install
npm run build
npm start
npm start prints the same address,
http://127.0.0.1:4777. To update, run git pull, then
npm install and npm run build again.
The
install guide
has every step, with what each command prints. The
guide
explains each part of the screen.
