Echo OS V1

Autonomous outbound infrastructure for Echo Growth Labs. Scrapes leads, validates emails, writes personalized sequences via Claude, handles replies, and books meetings — all orchestrated by an AI COO.

Branch: feat/v1-overnight | Status: V1 complete, pending API key wiring

Quickstart

pnpm install

# Dashboard (port 3000)
pnpm dev

# Landing page (port 3001)
pnpm dev:landing

# Production build check
pnpm build

Workspace structure

apps/
  dashboard/        — Echo OS internal dashboard (Next.js 14)
  landing/          — TextThread.co landing page (Next.js 14)
packages/
  db/               — Supabase migrations (24 tables) + TypeScript types
  agents/           — 8 agent skeletons + n8n workflow exports
  shared/           — Types, utils shared across apps

Dashboard pages (14 total)

Page	URL	Status
Overview	/overview	✓ Built (mock data)
COO Chat	/coo	✓ Built
Campaigns	/campaigns	✓ Built
Sequence Templates	/campaigns/templates	✓ Built
ICP Editor	/campaigns/icp	✓ Built
Rerun Cohorts	/campaigns/cohorts	✓ Built
Leads	/leads	✓ Built
Replies	/replies	✓ Built
Inboxes	/inboxes	✓ Built
Suppressions	/inboxes/suppressions	✓ Built
Domains	/domains	✓ Built
Agent Activity	/agents	✓ Built
Spend Monitor	/spend	✓ Built
Settings	/settings	✓ Built (6 tabs)

Agents (8 total)

All callable via POST /api/agents/<name>. All external API calls stubbed — add real keys to enable.

Agent	Trigger	External APIs
InboxProvisioner	manual	Instantly, Cloudflare
LeadScraper	scheduled	Apollo, Apify, Phantombuster, Hunter
Validator	after scrape	ZeroBounce, NeverBounce
Router	after validation	—
Personalizer	after routing	Anthropic (Claude)
CampaignWriter	after personalization	Anthropic (Claude)
ResponseHandler	reply webhook	Anthropic (Claude)
COO	chat	Anthropic (Claude)

Database

24 tables across 8 migration groups in packages/db/supabase/migrations/. See packages/db/README.md for migration instructions.

Note: Migrations require Supabase DB password (not the service role key). See RUNBOOK.md.

Design system

• Raw CSS from design/styles.css → apps/dashboard/app/globals.css
• CSS variables throughout, no hex literals in components
• Sharp corners (no border-radius)
• JetBrains Mono + Inter fonts
• Tabular-nums on all numeric displays

Links

• Scope doc: docs/echo-os-v1-scope-2026-05-05.md
• Runbook: RUNBOOK.md
• Open TODOs: TODO.md
• Env example: .env.example