Skip to content

cogniguardai/agentmonitor

Repository files navigation

AgentMonitor

Live PyPI Status License

See what your AI agent actually did.

Live at https://cogniguardai.com/v0.1.1 is on PyPI: pip install cogniguardai.

AgentMonitor is a flight recorder for AI agents. It records every prompt, tool call, file touched and dollar spent — so when your agent does something weird, you can rewind and see exactly what happened.

  • Local-first. Runs as a desktop app on your laptop. Your prompts never leave your machine.
  • Free. No signup, no telemetry, no cloud account. Forever.
  • Works with what you use. Cursor, Claude Code, OpenAI, Anthropic, LangChain, AutoGen, Smolagents, Ollama — and any custom agent.

Made by CogniGuard AI.

Install

Windows (no Python required) — download AgentMonitor.exe (20 MB) from the latest release and double-click. First launch may show a SmartScreen warning (not yet code-signed); click More info → Run anyway.

Python (any OS) —

pip install cogniguardai
agentmonitor   # opens the dashboard at http://127.0.0.1:8765

The slim baseline is ~174 KB on the wire and pulls only fastapi, uvicorn, pydantic, httpx, rich, PyYAML and pywebview — no torch, no transformers, no Playwright. Optional features ship as extras:

pip install 'cogniguardai[ml]'        # interp probes, NLA decoders, Llama Guard
pip install 'cogniguardai[browser]'   # Playwright session controller
pip install 'cogniguardai[all]'       # everything

Run from source

git clone https://github.com/cogniguardai/agentmonitor.git
cd agentmonitor
pip install -r requirements.txt
python -m agent_monitor.run_server
# then open http://127.0.0.1:8765

What it does

  1. Record. Every agent run is captured automatically — prompts, tool calls, files touched, tokens spent, money burned.
  2. Replay. Open any past run and scroll through it like a video.
  3. Rewind. When something goes wrong, you have the receipts.

Documentation

Repository layout

agent_monitor/   Python package (the recorder + dashboard backend)
marketing/       Source for the marketing site at cogniguardai.com
requirements.txt Python dependencies

License

MIT — see LICENSE.

Privacy

AgentMonitor does not phone home. Ever. All data lives in a local SQLite database on your machine. There is no analytics, no telemetry, no signup, no account.

About

Flight recorder for AI agents — every prompt, tool call, file, and dollar. Made by CogniGuard AI.

Topics

Resources

License

Stars

Watchers

Forks

Contributors