How zszz3/agentrecall works
AgentRecall is a desktop application for searching, inspecting, organizing, and resuming AI-coding-agent sessions. The README describes separate v1 and preview v2 applications with independent data stores. In v1, local agent sessions are indexed, queried, and presented for search and detail; optional branches cover remote sync, AI-assisted retrieval, skills, and MCP. V2 retains session management and adds reusable runtimes, multi-agent chat, workflows, evaluation, and directory memory. The sampled worker code confirms the v1 query path; other links reflect documented capabilities and tree structure, not inspected implementations.
Main entry points: App.tsx V1 Desktop UI · useRuntimeConfigManager.ts V2 Desktop UI · workflow-engine.ts Workflow Engine · local-session-query-service.ts Query Service
Components 25
V1 Sessions
- V1 Desktop UI
apps/main-1.0/src/renderer/src/App.tsx - Query Service
apps/main-1.0/src/main/services/local-session-query-service.ts - Query Worker
apps/main-1.0/src/main/session-query-worker.ts - Query Runner
apps/main-1.0/src/main/session-query-worker-runner.ts - Session Store
apps/main-1.0/src/core/session-store.ts - Session Indexer
apps/main-1.0/src/core/indexer.ts - Agent Session Files
- Session Detail
apps/main-1.0/src/renderer/src/features/session-detail/detail-panel.tsx - Resume / Migration
apps/main-1.0/src/core/resume-router.ts
V1 Extensions
- AI Retrieval
apps/main-1.0/src/core/ai-assistant.ts - Remote Sessions
apps/main-1.0/src/core/remote-session-sync.ts - Supabase
- Skills / Assets
apps/main-1.0/src/core/skill-manager.ts - MCP Tools
apps/main-1.0/src/mcp/migration-entry.ts
V2 Sessions
- V2 Desktop UI
apps/main-2.0/src/automation/engine/renderer/src/pages/runtime/hooks/useRuntimeConfigManager.ts - Session Platform
apps/main-2.0/src/core/postgres/session-repository.ts
V2 Automation
- Agent Chat
apps/main-2.0/src/automation/engine/main/hub/agent-hub.ts - Agent Runtime
apps/main-2.0/src/automation/engine/main/agents/runtime/runtime-router.ts - Workflow Engine
apps/main-2.0/src/automation/engine/main/workflows/workflow-engine.ts - Evaluation
apps/main-2.0/src/automation/engine/main/evaluation-runner.ts - Workflow Storage
apps/main-2.0/src/automation/engine/shared/workflow-v2/storage.ts
V2 Extensions
- MCP Gateway
apps/main-2.0/src/automation/engine/main/bridges/mcp-bridge.ts - Directory Memory
apps/main-2.0/src/automation/engine/main - Skill Library
apps/main-2.0/src/core/skill-manager.ts
Other components
- User
Connections 25
- User → V1 Desktop UI: search / inspect
- Agent Session Files → Session Indexer: index sessions
- Session Indexer → Session Store: write index
- V1 Desktop UI → Query Service: query sessions
- Query Service → Query Worker: dispatch request
- Query Worker → Query Runner: execute request
- Query Runner → Session Store: read sessions
- V1 Desktop UI → Session Detail: open details
- V1 Desktop UI → Resume / Migration: resume / migrate
- V1 Desktop UI → AI Retrieval: request AI help
- V1 Desktop UI → Remote Sessions: sync sessions
- Remote Sessions → Supabase: upload / restore
- V1 Desktop UI → Skills / Assets: manage skills
- V1 Desktop UI → MCP Tools: expose session tools
- User → V2 Desktop UI: use workbench
- V2 Desktop UI → Session Platform: search / manage
- V2 Desktop UI → Agent Chat: start agent chat
- V2 Desktop UI → Workflow Engine: run workflow
- V2 Desktop UI → Evaluation: run evaluation
- Agent Chat → Agent Runtime: route agent
- Workflow Engine → Agent Runtime: execute nodes
- Workflow Engine → Workflow Storage: load / save runs
- V2 Desktop UI → MCP Gateway: connect tools
- V2 Desktop UI → Directory Memory: manage directory memory
- V2 Desktop UI → Skill Library: manage skills