Agent Observer is a desktop-first observability workspace for AI agents, with a companion web surface for docs and interactive demo views.
- Monitor multiple AI agents in a shared 3D office and dashboard UI.
- Track statuses, token flow, file modifications, and celebration/event streams.
- Preview explorer-opened files across text, markdown, images, audio/video, and PDF with staged text diffs, image proposal diff/apply, and PDF proposal text diff preview.
- Offer a website installer endpoint (
/download) that serves the latest macOS (Apple Silicon).dmgbuild when release assets are available. - Run a production desktop app (Electron) plus a docs/demo web app (Next.js).
- Integrate local workflows, scheduled actions, and memory tooling.
src/: Electron desktop app (main, preload, renderer).web/: Next.js docs and web demo.tests/: Smoke test coverage.examples/: Example integrations and orchestrator samples.
- Node.js 22.x
- pnpm 10.12.4
- macOS (Apple Silicon) for packaged desktop artifacts
Optional helpers:
- Playwright browsers for smoke tests
- Xcode Command Line Tools (for macOS native build dependencies)
Install dependencies:
pnpm installRun desktop app in dev mode:
pnpm devRun web app in dev mode:
pnpm -C web devpnpm lint: Desktop lintpnpm lint:web: Web lintpnpm typecheck: TypeScript project build checkpnpm build: Desktop production buildpnpm -C web build: Web production buildpnpm test:smoke: Desktop smoke tests (Playwright)pnpm test:coverage: Coverage report for non-Electron smoke tests
- Web docs route:
/docs - Architecture docs:
/docs/architecture - Quickstart docs:
/docs/quickstart
- Contributing guide:
CONTRIBUTING.md - Runtime and Node types policy:
docs/engineering/node-runtime-types-policy.md - Code of conduct:
CODE_OF_CONDUCT.md - Security policy:
SECURITY.md - Support guide:
SUPPORT.md - Changelog:
CHANGELOG.md
MIT License. See LICENSE.