How mrtwister99-png/loyo-os works
LOYO OS is a locally run, manifest-driven agent workspace: users manage capabilities and personal work in a Tauri/React desktop app, while API orchestration routes commands to agents and local models and persists results as files. The graph preserves documented agent commands, capability builders, RAG/search, scheduling, MCP, and reporting branches. Source samples establish the UI-to-file path and orchestrator internals; many API routes and tool implementations were not sampled, so their internal wiring is intentionally left broad or unconnected.
Main entry points: orchestrator.ts Agent orchestrator · dataPaths.ts Notes and tasks · App.tsx Desktop UI · main.rs Desktop filesystem
Components 26
Desktop workspace
- Desktop UI
apps/web/src/App.tsx - Tasks editor
apps/web/src/pages/Tasks.tsx - File-backed lists
apps/web/src/hooks/useFileBackedList.ts - Desktop filesystem
apps/web/src-tauri/src/main.rs
API and agents
- API service
apps/api/src/index.ts - Agent orchestrator
apps/api/src/services/orchestrator.ts - Model routing
apps/api/src/services/modelRouter.ts - Activity feed
apps/api/src/routes/activity.ts - Run logging
apps/api/src/services/runLogger.ts - Scheduler
apps/api/src/services/scheduler.ts - Search routes
apps/api/src/routes/search.ts - RAG routes
apps/api/src/routes/rag.ts - Capability routes
apps/api/src/routes/capabilities.ts - MCP routes
apps/api/src/routes/mcp.ts
Manifest and data
- Manifest schema
packages/core/src/manifest/schema.ts - Manifest loader
packages/core/src/manifest/loader.ts - Capability files
apps/api/src/lib/dataPaths.ts - Notes and tasks
apps/web/src/lib/dataPaths.ts - Text search index
apps/api/src/lib/notesTasksFts.ts - Leads and reports
apps/api/src/services/orchestrator.ts
Model and tools
- MCP server
apps/mcp/src/server.ts - MCP tools
apps/mcp/src/tools/index.ts - Local Ollama
- Web research
apps/api/src/services/web_search.ts - Company lookup CLI
tools/cli/firmy/index.ts
Other components
- User
Connections 24
- User → Desktop UI: uses
- Desktop UI → Tasks editor: shows
- Tasks editor → Desktop filesystem: invokes file commands
- File-backed lists → Desktop filesystem: invokes file commands
- Desktop filesystem → Notes and tasks: reads and writes
- Desktop UI → API service: API requests
- API service → Agent orchestrator: dispatches chat
- Agent orchestrator → Model routing: selects model
- Agent orchestrator → Local Ollama: generates replies
- Agent orchestrator → Activity feed: logs activity
- Agent orchestrator → Run logging: logs runs
- Agent orchestrator → Capability files: reads manifests
- Agent orchestrator → Notes and tasks: reads and writes
- Agent orchestrator → Company lookup CLI: runs company lookup
- Agent orchestrator → Web research: requests research
- Agent orchestrator → Leads and reports: writes results
- Scheduler → Notes and tasks: persists notifications
- Search routes → Text search index: searches notes/tasks
- Text search index → Notes and tasks: indexes files
- RAG routes → Capability files: manages RAG manifests
- Capability routes → Manifest loader: loads capabilities
- Manifest loader → Manifest schema: validates against
- MCP server → MCP tools: dispatches tool calls
- MCP routes → MCP server: serves MCP