Repository navigation
Cato v0.1 - Live Marcus Visualization Dashboard
Cato v0.1 - Initial Release
Overview
Cato is a live visualization dashboard for Marcus multi-agent orchestration system. This initial release provides real-time monitoring and visualization of agent tasks, dependencies, conversations, and parallelization metrics.
Key Features
🔴 Live Data Mode
- Real-time connection to Marcus backend API
- Automatic 60-second background refresh
- On-demand refresh when clicking project dropdown
- Always shows newest/most recently active project
📊 Visualization Views
- Network Graph: Task dependencies and relationships
- Agent Swim Lanes: Timeline view of agent task execution with playback
- Conversation View: Agent message history with expandable details
- Health Dashboard: System metrics and status (in development)
🎮 Playback Controls
- Timeline scrubbing to review project execution
- Play/pause with adjustable speeds (0.5x - 10x)
- Preserved playback position during data refresh
- Linear timeline (1.0 power scale) for intuitive visualization
🔧 Project Management
- Project dropdown with automatic newest selection
- Real-time project list updates
- Single-project filtering
- Graceful handling of deleted projects
Technical Details
- Frontend: React + TypeScript + Zustand
- Backend: Python FastAPI
- Visualization: D3.js for network graphs
- State Management: Zustand with persistent playback state
UX Improvements in v0.1
- ✅ Removed mock mode complexity (live-only)
- ✅ Simplified header controls
- ✅ Background auto-refresh without UI clutter
- ✅ Automatic newest project selection on load
- ✅ Project list refreshes when dropdown clicked
- ✅ Fixed power scale consistency (0.4 → 1.0)
Known Issues
- Health dashboard view incomplete (type errors)
- Some pre-existing TypeScript warnings
Installation
See README.md for installation and setup instructions.
Next Steps
See GitHub issues for planned enhancements and feature requests.
🤖 Generated with Claude Code