How renzoramosdev/tony works
Tony is a local personal assistant with CLI and desktop entry points. A user sends a text or voice request; Jarvis handles conversation and delegates work to Viernes, whose tool calls are mediated by Edith’s deterministic permission policy before reaching native tools or MCP connectors. Results and events return to the interface. Major documented branches include voice, clarification, verified-source responses, routines, recovery/undo, and conversation history. The workflow edges reflect README documentation; source-level wiring is shown only where the supplied excerpts or index support it.
Main entry points: runtime.py Core runtime · proxy.py Tool proxy · runner.py Viernes worker · app.py Desktop app
Components 24
User interfaces
- CLI
tony/apps/cli/main.py - Desktop app
tony/apps/desktop/app.py - React interface
tony/apps/desktop/web/src/App.tsx
Assistant workflow
- Core runtime
tony/core/orchestrator/runtime.py - Jarvis front agent
tony/core/orchestrator/runner.py - Viernes worker
tony/core/orchestrator/runner.py - Claude engine
tony/core/orchestrator/claude_engine.py - Tool proxy
tony/core/orchestrator/proxy.py - Edith policy guard
tony/core/guard/policy.py
Tools and connectors
- MCP manager
tony/core/mcp/manager.py - Native tools
tony/core/orchestrator/natives.py - Tool definitions
tony/core/loader/tool_json.py - Configuration
tony/core/config/settings.py
Local state and recovery
- Conversation history
tony/core/memory/history.py - Action journal
tony/core/memory/actions.py - Task log
tony/core/logging/task_log.py - Core events
tony/core/events/core_events.py
Additional capabilities
- Clarification broker
tony/core/clarification/broker.py - Source validation
tony/core/evidence/validate.py - Voice service
tony/core/voice/service.py - Voice engines
tony/core/voice/engines/loader.py - Routine scheduler
tony/core/automation/scheduler.py - Task recovery
tony/core/recovery/tasks.py
Other components
- User
Connections 28
- User → CLI: sends request
- User → Desktop app: sends request
- CLI → Core runtime: submits commands
- Desktop app → Core runtime: starts runtime
tony/apps/desktop/app.py - Desktop app → React interface: hosts interface
- React interface → Core runtime: sends commands
- Core runtime → Jarvis front agent: routes turns
- Jarvis front agent → Viernes worker: delegates task
- Viernes worker → Tool proxy: requests tool
- Tool proxy → Edith policy guard: checks permission
- Edith policy guard → Tool proxy: returns ruling
- Tool proxy → MCP manager: dispatches MCP call
- Tool proxy → Native tools: dispatches native call
- Claude engine → Viernes worker: runs agent request
- Tool definitions → MCP manager: configures servers
tony/core/mcp/manager.py - Configuration → Core runtime: configures runtime
- Core runtime → Core events: publishes events
tony/apps/desktop/app.py - Core events → React interface: updates interface
- Core runtime → Conversation history: stores conversations
- Tool proxy → Action journal: journals actions
- Core runtime → Task log: records task events
tony/core/logging/task_log.py - Viernes worker → Clarification broker: asks user
- Viernes worker → Source validation: validates citations
- Desktop app → Voice service: creates voice service
tony/apps/desktop/app.py - Voice service → Voice engines: loads engines
tony/core/voice/service.py - Voice service → Jarvis front agent: provides spoken input
- Routine scheduler → Viernes worker: starts routine task
- Task recovery → Action journal: reads action records
tony/core/recovery/tasks.py