How edsuuu/magoagent works
MagoAgent is a native canvas for coordinating AI agents that run in real terminals. The main workflow is to arrange agents and project resources on the canvas, connect them, and let agents communicate through the CLI or MCP; people can monitor work in chat and the agent panel, including by voice. The README documents the major product branches; source excerpts and the index support selected internal relationships, but many UI and domain implementations were not sampled, so uncertain wiring is omitted.
Main entry points: app/mod.rs Canvas App · filetree/mod.rs File Tree · render/mod.rs Canvas Rendering · terminal/mod.rs Agent Terminals
Components 31
Canvas and Agents
- Canvas App
src/app/mod.rs - Canvas Editing
src/app/canvas/tool.rs - Agent Panel
src/app/ui/agents.rs - Maestro Teams
src/app/maestro/mod.rs - Agent Terminals
src/app/terminal/mod.rs - PTY Runtime
src/terminal/mod.rs - Agent Chat
src/app/chat/mod.rs - Sticky Notes
src/app/notes/stack.rs
Project Workspace
- Browser Portals
src/app/browser/mod.rs - File Tree
src/app/filetree/mod.rs - Code IDE
src/ide/mod.rs - Text Editing
src/ide/text.rs - Code Hints
src/ide/hints.rs - Git Tools
src/ide/merge.rs - Database Panel
src/db/mod.rs - Data Grid
src/db/grid.rs - Web View
Agent Interfaces
- Local Agent Bridge
src/bridge/server.rs - Bridge Client
src/bridge/client.rs - MCP Server
src/mcp/mod.rs - MCP App Tools
src/mcp/app_tools.rs
App and Rendering
- Canvas Model
src/model/scene.rs - Drawing Storage
src/file/mod.rs - Canvas Rendering
src/render/mod.rs - Stroke Replay
src/render/replay.rs - Hand Drawn Style
src/render/rough.rs - SVG Export
src/render/svg.rs
Voice Control
- Voice Call
src/voice/mod.rs - Voice UI
src/app/voice/mod.rs - Speech Services
Other components
- Person
Connections 32
- Person → Canvas App: uses
README.md - Canvas App → Canvas Editing: provides editing
- Canvas App → Agent Panel: shows status
README.md - Canvas App → Agent Terminals: hosts agents
README.md - Agent Terminals → PTY Runtime: runs shell
README.md - Canvas App → Agent Chat: shows conversations
README.md - Canvas App → Sticky Notes: hosts notes
README.md - Maestro Teams → Agent Terminals: recruits agents
README.md - Agent Terminals → Local Agent Bridge: uses CLI
README.md - Local Agent Bridge → Bridge Client: exchanges requests
- Person → MCP Server: connects AI client
README.md - MCP Server → MCP App Tools: dispatches app tools
src/mcp/mod.rs - MCP App Tools → Canvas App: controls app
README.md - MCP Server → Drawing Storage: reads shared autosave
src/mcp/mod.rs - Canvas App → File Tree: hosts project tree
README.md - File Tree → Code IDE: opens code pane
src/app/filetree/mod.rs - Code IDE → Text Editing: uses text tools
src/ide/mod.rs - Code IDE → Code Hints: provides hints
src/ide/mod.rs - File Tree → Git Tools: shows changes
README.md - File Tree → Database Panel: hosts database panel
src/app/filetree/mod.rs - Database Panel → Data Grid: displays tables
src/db/mod.rs - Canvas App → Browser Portals: hosts portals
README.md - Browser Portals → Web View: displays pages
- Canvas App → Canvas Model: edits scene
- Canvas App → Canvas Rendering: draws canvas
src/main.rs - Canvas Rendering → Stroke Replay: replays strokes
src/render/mod.rs - Canvas Rendering → Hand Drawn Style: uses hand style
src/render/mod.rs - Canvas Rendering → SVG Export: exports SVG
src/render/mod.rs - Person → Voice UI: gives spoken commands
README.md - Voice UI → Voice Call: controls call
- Voice Call → Speech Services: uses speech engines
src/voice/mod.rs - Voice Call → Canvas App: triggers app actions
README.md