How uselexora/lexora works
Lexora is a local-first desktop AI agent: people create tasks, converse with an agent, authorize local access, and review work products. The documented product spans a Vue/Electron desktop, API, and independent TypeScript agent runtime; the sampled runtime entry point wires chat, memory, skills, model, search, Redis, and checkpoint dependencies. The README also documents automations, MCP, sandboxed tools, and native Rust capabilities. Several links for those unsampled features are therefore documented relationships, not inspected call paths.
Main entry points: main.ts Agent service · DesktopApplication.ts Electron desktop · chat-sessions.service.ts Chat sessions · runner.ts Agent runner
Components 24
Desktop experience
- Electron desktop
apps/buddy/electron/main/app/DesktopApplication.ts - Task index
apps/buddy/src/modules/tasks/widgets/task-index/useTaskIndexController.ts - Web chat engine
apps/web/src/composables/chat/createChatEngine.ts - Skills manager
apps/buddy/src/modules/skills/state/useSkillsManager.ts - Automations
apps/buddy/electron/main/local-chat/automations.ts
API services
- API application
apps/api/src/app.module.ts - Chat sessions
apps/api/src/modules/chat/chat-sessions.service.ts - Agent profiles
apps/api/src/modules/agent/agent-profiles.service.ts - Skill services
apps/api/src/modules/agent/agent-skills.service.ts - Authentication
apps/api/src/modules/auth/auth.service.ts
Agent runtime
- Agent service
apps/agent/src/main.ts - Agent runner
apps/agent/src/core/runner.ts - Runtime config
apps/agent/src/config/runtime-config.ts - Model provider
apps/agent/src/integrations/model-providers/chat-model.ts - Web search
apps/agent/src/integrations/web-search/index.ts
Local execution
- Permission engine
apps/buddy/service/src/permissions/PermissionEngine.ts - Browser integration
apps/buddy/electron/main/browser/BrowserIntegration.ts - MCP tools
apps/agent/src/core/skills/action-providers/mcp/provider.ts
State and integrations
- Object storage
apps/api/src/infrastructure/storage/storage.service.ts - API database
apps/api/src/database/prisma.service.ts - Runtime streams
apps/agent/src/integrations/redis-streams.ts - Runtime locks
apps/agent/src/integrations/redis-lock.ts - Checkpoint store
apps/agent/src/runtime/checkpointer.ts
Other components
- User
Connections 25
- User → Electron desktop: starts tasks
README.md - Electron desktop → Task index: manages tasks
README.md - Electron desktop → Web chat engine: offers chat
- Web chat engine → Chat sessions: persists sessions
- Chat sessions → Agent profiles: resolves profile
apps/api/src/modules/chat/chat-sessions.service.ts - Chat sessions → API database: reads and writes
apps/api/src/modules/chat/chat-sessions.service.ts - API application → Chat sessions: routes chat
- API application → Authentication: routes authentication
- Authentication → API database: uses Prisma
apps/api/src/modules/auth/auth.service.ts - Agent service → Runtime config: loads config
apps/agent/src/main.ts - Agent service → Agent runner: creates runner
apps/agent/src/main.ts - Agent service → Model provider: creates model factory
apps/agent/src/main.ts - Agent service → Runtime streams: wires streams
apps/agent/src/main.ts - Agent service → Runtime locks: creates locks
apps/agent/src/main.ts - Agent service → Checkpoint store: creates checkpointer
apps/agent/src/main.ts - Agent service → Web search: creates search client
apps/agent/src/main.ts - Agent service → Chat sessions: uses chat API
- Skills manager → Skill services: manages skills
- Electron desktop → Permission engine: authorizes local tools
README.md - Electron desktop → Browser integration: provides browser tools
README.md - Electron desktop → Automations: schedules tasks
README.md - Agent runner → Permission engine: requests authorized execution
README.md - Agent runner → MCP tools: uses extensible tools
README.md - Chat sessions → Object storage: serves chat assets
- User → Authentication: signs in