How loopx-project/loopx works
LoopX is a local-first control plane for durable, long-running agent goals: a person starts work through a supported agent host, LoopX tracks governed turns and continuation, and the person reviews progress and evidence in the workspace. The README describes collaboration, recovery, scheduling, capability configuration, and cross-runtime sessions as additional product capabilities. Source excerpts show selected storage, runtime, and evidence boundaries; the wider control-plane map is based on the README and SOURCE INDEX, so unsampled connections are omitted.
Main entry points: turn_driver Turn driver · effect_runtime.py Effect runtime · cli_commands Goal setup · chat_manager.py Manager service
Components 27
User entry
- Goal setup
loopx/cli_commands - Chat service
loopx/chat.py - Manager service
loopx/chat_manager.py
Goal governance
- Turn controller
loopx/control_plane/turn_driver/loop_controller.py - Agent registry
loopx/agent_registry.py - Todo contracts
loopx/control_plane/todos/contract.py - Authority coordination
loopx/control_plane/coordination - PostgreSQL authority
loopx/control_plane/coordination/postgresql_authority_service.ts - Storage configuration
loopx/capabilities/machine_configuration/goal_storage.py
Turn runtime
- Turn driver
loopx/control_plane/turn_driver - Effect runtime
loopx/control_plane/effect_runtime.py - Repository context
loopx/capabilities/issue_fix/repository_context.py - Runtime selection
apps/desktop/loopx-control-plane/src-tauri/src/runtime_selection.rs
State and evidence
- Manager evidence
loopx/chat_manager_context.py - Project registry
loopx/control_plane/projects/registry_codec.py - Runtime shadow
loopx/control_plane/coordination/runtime_shadow.py - Storage API
loopx/presentation/goal_storage_api.py - Reward memory
loopx/capabilities/reward_memory/application.py
Workspace and integrations
- Personal workspace
apps/presentation/dashboard/src/features/personal-workspace/personal-workspace-page.tsx - Chat interface
apps/presentation/dashboard/src/chat-main.tsx - Storage settings
apps/presentation/dashboard/src/features/personal-workspace/goal-storage-settings.tsx - Storage client
apps/presentation/dashboard/src/data/goal-storage.ts - Manager inbox
loopx/cli_commands/manager_inbox.py - Lark connector
loopx/extensions/lark/manager_context.py - Desktop shell
apps/desktop/loopx-control-plane/src-tauri/src/services.rs
Other components
- Goal owner
- Agent host
Connections 33
- Goal owner → Agent host: starts work
README.md - Agent host → Goal setup: requests a goal
README.md - Goal setup → Todo contracts: plans as Todos
README.md - Goal setup → Turn controller: sets continuation
README.md - Agent host → Turn driver: runs turns
README.md - Turn controller → Turn driver: governs continuation
loopx/control_plane/turn_driver/loop_controller.py - Turn driver → Effect runtime: dispatches effects
loopx/control_plane/turn_driver/loop_controller.py - Turn driver → Agent registry: resolves agents
loopx/agent_registry.py - Agent registry → Todo contracts: reads contracts
loopx/agent_registry.py - Turn controller → Todo contracts: selects work
loopx/control_plane/turn_driver/loop_controller.py - Turn controller → Authority coordination: validates authority
- Authority coordination → PostgreSQL authority: uses service
loopx/control_plane/coordination/postgresql_authority_service.ts - Effect runtime → Runtime shadow: captures effects
loopx/control_plane/coordination/runtime_shadow.py - Runtime shadow → Agent registry: reads agents
loopx/control_plane/coordination/runtime_shadow.py - Runtime shadow → Project registry: reads registry
loopx/control_plane/coordination/runtime_shadow.py - Goal setup → Project registry: registers projects
loopx/cli_commands/manager_inbox.py - Goal owner → Personal workspace: reviews progress
README.md - Personal workspace → Chat interface: opens chat
- Chat interface → Chat service: requests chat
- Chat service → Manager service: delegates manager chat
loopx/chat_manager.py - Manager service → Manager evidence: uses evidence
loopx/chat_manager_context.py - Personal workspace → Storage settings: configures storage
README.md - Storage settings → Storage client: reads and previews
apps/presentation/dashboard/src/features/personal-workspace/goal-storage-settings.tsx - Storage client → Storage API: calls API
apps/presentation/dashboard/src/data/goal-storage.ts - Storage API → Runtime shadow: inspects source
loopx/presentation/goal_storage_api.py - Storage API → Effect runtime: requests effects
loopx/presentation/goal_storage_api.py - Storage configuration → Effect runtime: resolves storage
loopx/capabilities/machine_configuration/goal_storage.py - Turn driver → Repository context: uses context
- Manager service → Manager inbox: supports inbox
- Manager service → Lark connector: connects conversations
- Effect runtime → Reward memory: supports recall
- Desktop shell → Runtime selection: selects runtime
apps/desktop/loopx-control-plane/src-tauri/src/services.rs - Goal owner → Desktop shell: uses desktop app
README.md