A real-time monitoring and documentation engine for multi-agent workflows. Tracks agent activity, detects hallucinations, and manages agent replacement.

Layer 1 - Real-Time Documentation: Continuously tracks every agent action and streams it into per-agent markdown files. Documents the model, prompt, files touched, and summaries.

Layer 2 - Real-Time Monitoring: Watches all agent markdown files for hallucinations. When detected: interrupts the agent, notifies the user, suggests prebuilt replacement agents from the registry, and onboards the new agent with full context.

Graph Visualization: Each agent's markdown file is rendered as a visual process graph showing steps, hallucination flags, and agent replacements.

• Framework: Next.js 16 (App Router)
• Styling: TailwindCSS
• Database: SQLite via Prisma
• Real-time: Server-Sent Events (SSE)
• File watching: chokidar
• Graph: reactflow
• State: Zustand

cp .env.example .env.local
# Add NIA_API_KEY and/or CLOD_API_KEY for Layer 2 (see below)

npm install
npx prisma migrate dev --name init
npx prisma generate
npx tsx prisma/seed.ts
npm run dev

Human-in-the-loop: POST /api/monitor/evaluate runs rules → Nia → CloD. If flagged, the agent moves to awaiting_replacement until a human confirms POST /api/agents/:id/replace with humanConfirmed: true.

• Abdulrahman: Layer 1 + Layer 2 engine, hallucination detection, agent registry
• Abdullah: Graph visualization system
• zaimen: Frontend, dashboard, UI components
• Tejas: MCP integration, API routes, webhooks

src/
├── app/           # Next.js pages + API routes
├── engine/        # Core engine (Layer 1, Layer 2, MCP)
├── components/    # React components
├── hooks/         # Custom React hooks
├── lib/           # Utilities
└── store/         # Zustand stores