How huangruiteng/loopx works
LoopX is a local-first control plane for durable agent goals and personal agent teams. The principal workflow is to configure a goal, let LoopX govern permitted bounded turns across sessions, preserve evidence and handoffs, then surface progress and owner decisions in the workspace. Collaboration, manager conversations, integrations, and evidence/reward-memory capabilities extend that loop. The README documents the broad product flow; sampled source confirms selected control, context, and UI behaviors, but does not expose the full turn-runner or storage wiring.
Main entry points: turn_driver Turn driver · loopx Goal state · personal-workspace-page.tsx Workspace UI · status.ts Workspace data
Components 20
Personal workspace
- Workspace UI
apps/presentation/dashboard/src/features/personal-workspace/personal-workspace-page.tsx - Workspace data
apps/presentation/dashboard/src/data/status.ts - Goal settings
apps/presentation/dashboard/src/features/personal-workspace/goal-capability-settings.tsx
Goal governance
- Goal lifecycle
loopx/control_plane/goals - Turn driver
loopx/control_plane/turn_driver - Loop controller
loopx/control_plane/turn_driver/loop_controller.py - Scheduler and quota
loopx/control_plane - Goal state
loopx - Authority service
loopx/control_plane/coordination/postgresql_authority_service.ts - PostgreSQL
Agent execution
- Agent runtimes
- Session lifecycle
loopx/control_plane/goals/source_session_services.py
Team collaboration
- Peer work
loopx/control_plane/collaboration - Manager inbox
loopx/cli_commands/manager_inbox.py - Team results
apps/presentation/dashboard/src/features/personal-workspace/manager-team-result.tsx
Evidence and integrations
- Manager evidence
loopx/chat_manager_context.py - Issue context
loopx/capabilities/issue_fix/repository_context.py - Reward memory
loopx/capabilities/reward_memory/application.py - Lark delivery
loopx/extensions/lark/manager_reply_parts.py
Other components
- Owner
Connections 20
- Owner → Workspace UI: steers work
- Workspace UI → Goal settings: configures goals
- Workspace UI → Workspace data: requests status
- Workspace data → Goal state: reads projections
- Goal settings → Goal lifecycle: updates settings
- Goal lifecycle → Goal state: manages state
- Turn driver → Scheduler and quota: requests decision
- Turn driver → Agent runtimes: dispatches turn
- Agent runtimes → Turn driver: returns receipt
- Loop controller → Turn driver: validates disposition
- Turn driver → Goal state: writes handoff
- Session lifecycle → Goal lifecycle: binds sessions
- Peer work → Goal state: records claims
- Manager inbox → Peer work: requests peer work
- Workspace UI → Team results: opens results
- Team results → Workspace data: fetches team work
- Manager evidence → Goal state: reads delivery history
- Issue context → Reward memory: composes memory source
- Manager inbox → Lark delivery: delivers replies
- Authority service → PostgreSQL: opens store