How dario90vlc/sagitari works
SAGITARI is a Windows desktop AI agent: the user submits a request in chat, Electron routes it to an agent that plans and executes permitted tools, then streams progress and results back to the interface. The agent also supports background tasks, project-aware coding, memory, skills, and MCP tools. Voice is a separate input/output path integrated through the same desktop boundary. The README documents these capabilities; sampled source confirms parts of the agent, IPC, task, and voice behavior, so uncertain internal links are omitted.
Main entry points: agent.js Agent loop · main.js Electron main · manager.js Voice manager · preload.js Renderer bridge
Components 26
Desktop interface
- Chat interface
renderer/10-chat.js - Settings interface
renderer/30-ajustes.js - Voice interface
renderer/20-voz.js - Renderer bridge
main/preload.js - Electron main
main/main.js
Agent runtime
- Agent loop
agent/agent.js - Context budgeting
agent/contexto.js - Safety controls
agent/guardrails.js - Model routing
agent/models.js - Project awareness
agent/proyecto.js - Project map
agent/repomap.js - Skills
agent/skills.js
Action capabilities
- Tool registry
agent/tools.js - Browser control
agent/browser.js - MCP integration
agent/mcp.js
Local state
- Background tasks
agent/tasks.js - Run checkpoints
agent/checkpoints.js - Memory and habits
agent/memory.js
Voice
- Voice IPC
main/ipc-voz.js - Voice manager
main/voice/manager.js - Local dictation
main/voice/whisper.js - Speech engines
main/voice/tts-local.js
Other components
- User
- Windows desktop
- Model provider
- MCP servers
Connections 28
- User → Chat interface: submits request
- Chat interface → Renderer bridge: sends chat
- Settings interface → Renderer bridge: updates configuration
- Voice interface → Renderer bridge: sends voice events
- Renderer bridge → Electron main: forwards IPC
- Electron main → Agent loop: starts agent
- Agent loop → Context budgeting: budgets prompt
- Agent loop → Safety controls: checks actions
- Agent loop → Tool registry: dispatches tools
- Agent loop → Model routing: requests completion
- Model routing → Model provider: calls model
- Agent loop → Project awareness: loads project context
- Project awareness → Project map: uses project map
- Agent loop → Skills: loads skill instructions
- Agent loop → Memory and habits: uses local memory
- Agent loop → MCP integration: dispatches MCP tools
- MCP integration → MCP servers: calls server tools
- Tool registry → Browser control: uses browser
- Tool registry → Windows desktop: acts on desktop
- Electron main → Background tasks: routes task requests
- Background tasks → Agent loop: creates task agents
- Background tasks → Run checkpoints: saves run state
- Electron main → Voice IPC: routes voice IPC
- Voice IPC → Voice manager: controls voice session
- Voice manager → Local dictation: transcribes audio
- Voice manager → Speech engines: synthesizes speech
- Electron main → Chat interface: streams agent events
- Voice manager → Voice interface: emits voice events