How maka-agent/maka-agent works
Maka is a local-first agent workspace whose central workflow is: a user starts a task in Desktop or a terminal client, the Runtime Host executes it through a session and agent run, and an append-only event record supports the resulting UI, future prompts, and recovery. The README also describes evaluation as a separate experiment/cell/attempt/results flow that uses the same execution authority. Edges are based on README statements and SOURCE INDEX references; unsampled implementation details are represented only at documented subsystem boundaries.
Main entry points: runtime Agent Run · storage Runtime Event Log · runtime-host Runtime Host · plugin-runtime.ts Plugin Runtime
Components 21
User Clients
- Desktop
apps/desktop/src/renderer/app.tsx - TUI and CLI
packages/cli
Execution Runtime
- Runtime Host
packages/runtime-host - Session Manager
packages/runtime/src/session-manager.ts - Agent Run
packages/runtime - Model and Tools
packages/runtime/src/tool-runtime.ts - Plugin Runtime
packages/runtime/src/plugin-runtime.ts - Plugin Agents
packages/runtime/src/plugin-agent-service.ts - Plugin LLM
packages/runtime/src/plugin-llm-service.ts - Plugin Queries
packages/runtime/src/plugin-session-query-service.ts - MCP Integration
packages/mcp/src/index.ts - Computer Use
packages/computer-use/src/maka-cu-service.ts
Records and Projections
- Runtime Event Log
packages/storage - Local State
packages/storage/src/storage-writer-composition.ts - Long-Term Memory
packages/storage/src/long-term-memory-store.ts - UI Projections
packages/ui
Evaluation
- Experiment
packages/eval - Cells
packages/eval - Attempts
packages/eval - Results
packages/eval
Other components
- User
Connections 23
- User → Desktop: starts task
README.md - User → TUI and CLI: starts task
README.md - Desktop → Runtime Host: requests execution
README.md - TUI and CLI → Runtime Host: requests execution
README.md - Runtime Host → Session Manager: dispatches to
README.md - Session Manager → Agent Run: runs session
README.md - Agent Run → Model and Tools: uses
README.md - Model and Tools → Runtime Event Log: appends events
README.md - Runtime Event Log → UI Projections: projects into UI
README.md - Runtime Event Log → Agent Run: informs next prompt
README.md - Runtime Event Log → Session Manager: supports recovery
README.md - Plugin Runtime → Plugin Agents: provides service
packages/runtime/src/plugin-agent-service.ts - Plugin Runtime → Plugin LLM: provides service
packages/runtime/src/plugin-llm-service.ts - Plugin Runtime → Plugin Queries: provides service
packages/runtime/src/plugin-session-query-service.ts - Plugin Agents → Plugin LLM: supplies invocation
packages/runtime/src/plugin-llm-service.ts - Plugin Agents → Plugin Queries: supplies caller
packages/runtime/src/plugin-session-query-service.ts - Agent Run → MCP Integration: uses integration
- Agent Run → Computer Use: uses integration
- Local State → Long-Term Memory: opens store
packages/storage/src/storage-writer-composition.ts - Experiment → Cells: defines
README.md - Cells → Attempts: runs
README.md - Attempts → Results: produces
README.md - Attempts → Runtime Host: executes subjects
README.md