How shipshitdev/shiplead works
Shiplead is a local-first, self-hosted CRM and agentic SDR cockpit. Operators manage projects, brands, offers, companies, contacts, leads, pipeline, tasks, and inbox work through the desktop app or CLI; the API coordinates CRM operations and persists workspace state in SQLite. Enrichment, reply triage, and sequence advancement are distinct automation stages, with channel adapters available for copilot workflows. The README also documents a web surface. Some UI-to-API wiring and unsampled API capabilities are described only at a high level, so those links are marked unverified or omitted.
Main entry points: app.ts API orchestration · src/index.ts SQLite store · server.ts HTTP server · src/index.ts CLI commands
Components 22
API and runtime
- HTTP server
apps/api/src/server.ts - API orchestration
apps/api/src/app.ts - Local API manager
apps/desktop/src/main/api-service.ts
CRM workflows
- CRM operations
apps/api/src/app.ts - Lead enrichment
packages/enrichment/src/index.ts - Reply triage
apps/api/src/app.ts - Sequence cadence
packages/sequences/src/index.ts
Agent automation
- SDR agents
packages/agents/src/index.ts - Channel copilot
packages/channels/src/index.ts
Local data
- SQLite store
packages/db/src/index.ts - Database schema
packages/db/src/schema.ts - Demo workspace data
packages/shared/src/demo-data.ts - Types and schemas
packages/shared/src/schemas.ts
Operator surfaces
- Desktop cockpit
apps/desktop/src/renderer/App.tsx - Desktop renderer entry
apps/desktop/src/renderer/main.tsx - Desktop main process
apps/desktop/src/main/index.ts - CLI commands
apps/cli/src/index.ts - Web landing page
apps/web/app/page.tsx - Product landing content
apps/web/app/components/Hero.tsx
Other components
- Sales operator
- CLI user
- Web visitor
Connections 22
- HTTP server → API orchestration: routes requests
apps/api/src/server.ts - HTTP server → SQLite store: opens store
apps/api/src/server.ts - API orchestration → SQLite store: reads and writes
apps/api/src/app.ts - API orchestration → Lead enrichment: enriches lead
apps/api/src/app.ts - API orchestration → Reply triage: triages replies
apps/api/src/app.ts - API orchestration → Sequence cadence: advances cadence
apps/api/src/app.ts - API orchestration → SDR agents: requests agent work
apps/api/src/app.ts - API orchestration → Channel copilot: uses adapters
- SQLite store → Database schema: runs migrations
packages/db/src/index.ts - SQLite store → Demo workspace data: seeds workspace
- CLI user → CLI commands: runs commands
apps/cli/src/index.ts - CLI commands → HTTP server: starts server
apps/cli/src/index.ts - CLI commands → SQLite store: runs local operations
apps/cli/src/index.ts - Sales operator → Desktop cockpit: works in cockpit
- Desktop renderer entry → Desktop cockpit: renders
apps/desktop/src/renderer/main.tsx - Desktop main process → Local API manager: uses API manager
apps/desktop/src/main/index.ts - Local API manager → HTTP server: boots local API
- Desktop cockpit → API orchestration: uses CRM API
- Web visitor → Web landing page: opens landing page
- Web landing page → Product landing content: renders hero
apps/web/app/page.tsx - SDR agents → Types and schemas: uses shared types
packages/agents/src/index.ts - API orchestration → Types and schemas: validates inputs