How codestrate/wefty works
Wefty is a local-first desktop library for coding-agent sessions, memories, and project context. Its main workflow scans enabled harnesses, normalizes their data into a shared library, then presents it in timeline, graph, and list views with search and detail editors. Users can resume work in embedded terminals or create Markdown handoffs. The graph preserves documented capabilities, but some links—especially renderer-to-preload IPC wiring and unsampled subsystems—are shown only where the README or source index supports them.
Main entry points: home-view.tsx Library home · library.ts Library scanner · terminal-context.tsx Terminal state · library-api.ts Library API
Components 26
Library collection
- Library contract
main/shared/types.ts - Library scanner
main/services/library.ts - Harness readers
main/services/harnesses - Memory files
main/services/memory-files.ts - Preferences
main/services/preferences.ts - Platform paths
main/services/platform.ts - File utilities
main/services/util.ts
Library workspace
- Library home
renderer/main/home-view.tsx - Timeline view
renderer/components/river-pane.tsx - Graph view
renderer/components/graph-pane.tsx - List view
renderer/components/list-pane.tsx - Transcript reader
renderer/components/detail/session-detail.tsx - Memory editor
renderer/components/detail/memory-detail.tsx - Library API
renderer/lib/library-api.ts - Search state
renderer/lib/search.ts
Work continuation
- Handoff builder
main/services/handoff.ts - PTY terminal
main/services/terminal.ts - Terminal state
renderer/lib/terminal-context.tsx - Terminal panel
renderer/components/terminal/terminal-dock.tsx
App runtime
- IPC registration
main/handlers/index.ts - Library handlers
main/handlers/library.ts - Terminal handlers
main/handlers/terminal.ts - Preload bridge
renderer/preload.ts - Settings view
renderer/settings/settings-view.tsx
Other components
- Developer
- Agent files
Connections 29
- Agent files → Library scanner: scanned by
README.md - Library scanner → Harness readers: dispatches scans
main/services/library.ts - Library scanner → Preferences: reads settings
main/services/library.ts - Library scanner → Memory files: uses
main/services/library.ts - Library scanner → Library contract: produces
main/shared/types.ts - Harness readers → Library contract: normalizes to
README.md - File utilities → Platform paths: uses paths
main/services/util.ts - IPC registration → Library handlers: registers
main/handlers/index.ts - IPC registration → Terminal handlers: registers
main/handlers/index.ts - Library handlers → Library scanner: serves library
main/handlers/library.ts - Terminal handlers → PTY terminal: serves terminals
main/handlers/terminal.ts - Library home → Timeline view: renders
renderer/main/home-view.tsx - Library home → Graph view: renders
renderer/main/home-view.tsx - Library home → List view: renders
renderer/main/home-view.tsx - Library home → Transcript reader: renders
renderer/main/home-view.tsx - Library home → Memory editor: renders
renderer/main/home-view.tsx - Library home → Library API: reads and mutates
renderer/main/home-view.tsx - Library home → Search state: uses route state
renderer/main/router.tsx - Timeline view → Developer: shows activity
README.md - Graph view → Developer: shows relationships
README.md - List view → Developer: shows items
README.md - Transcript reader → Library API: requests handoff
renderer/components/detail/session-detail.tsx - Library scanner → Handoff builder: builds handoff
main/services/library.ts - Developer → Terminal panel: resumes work
README.md - Terminal panel → Terminal state: uses tabs
renderer/components/terminal/terminal-dock.tsx - Terminal state → PTY terminal: opens and writes
README.md - Library API → Preload bridge: IPC bridge
- Terminal state → Preload bridge: IPC bridge
- Developer → Settings view: configures harnesses
README.md