How agentprojectcontext/apx works
APX is a local-first home for AI-agent teams, exposed through desktop, web, phone, and messaging interfaces. The main workflow is an owner request entering a thread, becoming a durable run, executing an agent turn with tools or delegation, and reporting the outcome. Other documented product branches include project crews, tasks, routines, memory, browser/computer use, integrations, and widgets. Some connections below come from README claims or indexed imports; unsampled implementation details are not inferred.
Main entry points: engine.ts Agent turn engine · turn.ts Turn execution · types.ts Agent tools · store.ts Domain store
Components 22
Owner interfaces
- Desktop app
apps/desktop/src/main/main.ts - Phone app
apps/mobile/src/App.tsx - Web panel
apps/web/src/App.tsx - Messaging channels
apps/core/src/channels/manager.ts
Agent orchestration
- Core service
apps/core/src/server.ts - Agent turn engine
apps/core/src/engine/engine.ts - Turn execution
apps/core/src/engine/turn.ts - Agent delegation
apps/core/src/engine/delegation.ts
Work and memory
- Project agents
apps/core/src/domain/agents.ts - Tasks and commitments
apps/core/src/domain/tasks.ts - Scheduled routines
apps/core/src/domain/routines.ts - Agent memory
apps/core/src/engine/memory-capture.ts
Agent capabilities
- Agent tools
apps/core/src/tools/types.ts - Browser and computer
apps/core/src/tools/browser.ts - Model providers
apps/core/src/providers/registry.ts - CLI harnesses
apps/core/src/harness/env.ts - External integrations
apps/core/src/integrations/catalog.ts - Widgets and apps
packages/surfaces/src/widget-kit.ts
Persistence
- Durable runs
apps/core/src/domain/runs.ts - Domain store
apps/core/src/domain/store.ts - SQLite database
apps/core/src/db/db.ts
Other components
- Owner
Connections 24
- Owner → Desktop app: uses
README.md - Owner → Phone app: uses
README.md - Owner → Web panel: uses
README.md - Owner → Messaging channels: messages
README.md - Desktop app → Core service: connects to
README.md - Phone app → Core service: pairs with
README.md - Web panel → Core service: uses
- Messaging channels → Agent turn engine: starts turns
apps/core/src/channels/manager.ts - Agent turn engine → Durable runs: queues turns
apps/core/src/engine/engine.ts - Agent turn engine → Turn execution: runs turn
apps/core/src/engine/engine.ts - Agent turn engine → Agent delegation: creates delegations
apps/core/src/engine/engine.ts - Agent turn engine → Domain store: uses
apps/core/src/engine/engine.ts - Domain store → SQLite database: uses
apps/core/src/domain/store.ts - Domain store → Durable runs: provides repository
apps/core/src/domain/store.ts - Turn execution → Agent tools: uses
- Turn execution → Model providers: requests completion
- Turn execution → CLI harnesses: runs sessions
- Agent tools → Browser and computer: includes
README.md - Agent tools → External integrations: accesses
- Agent delegation → Project agents: delegates to
README.md - Owner → Tasks and commitments: assigns work
README.md - Owner → Scheduled routines: schedules work
README.md - Turn execution → Agent memory: learns from turns
- Owner → Widgets and apps: requests widgets
README.md