Skip to content

jay-sahnan/signal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Signal

Open-source AI sales intelligence and outreach automation.

The open alternative to Clay, Apollo, and Outreach — run it on your own keys.

License: AGPL v3 PRs Welcome Built with Claude Stars

🌐 Website  ·  📚 Docs  ·  🏗️ Architecture  ·  ⚡ Quick start  ·  💬 Discussions



Signal watches the web for buying signals (hiring changes, funding news, product launches, review shifts), enriches the companies and contacts behind them, drafts personalized outreach, and runs multi-step email sequences — all from a single chat-first workspace.

It's built for teams that want a CRM-adjacent tool they can read, fork, self-host, and extend. Instead of paying per seat for a black-box SaaS, run Signal on your own Supabase + Anthropic keys and own the pipeline end to end.

🧪 Signal is designed for single-tenant self-hosting — one Supabase project per team. See architecture.md before deploying for multiple independent teams.

⚠️ Upgrading from a pre-Clerk version? Auth has migrated from Supabase Auth to Clerk (Supabase remains the data layer). Take a pg_dump first — this migration is destructive and not reversible. It wipes all user-owned data (campaigns, chats, user_profile, api_usage, user_settings, email_drafts, sent_emails, sequences, plus user-authored email_skills) — old Supabase user UUIDs don't map to Clerk IDs. Built-in seed data and shared pools (organizations, people, signals) survive. Sign up for a free Clerk account (10k MAU free) and run pnpm setup to wire it up. See docs/setup.md § Clerk and supabase/migrations/20260427000000_clerk_auth_migration.sql if you need a custom backfill.


✨ Features

  • 🛰️ Signals engine — authorable "recipes" that watch companies and surface buying triggers.
  • 💬 Campaign workspace — chat-driven interface backed by Claude to research, shortlist, and draft.
  • 🔎 Contact enrichment — pulls LinkedIn, GitHub, and company pages into a single profile.
  • ✉️ Outreach sequences — multi-step emails via AgentMail with open / reply tracking.
  • 🤖 Browser automation — Browserbase + Stagehand for the long tail of sites without APIs.
  • 🔐 Own your data — Postgres + RLS on your Supabase; bring your own LLM keys.

🛠️ Tech stack

  • Framework — Next.js 16 (App Router) + React 19 + TypeScript
  • Database — Supabase (Postgres + Auth + RLS)
  • AI — Anthropic Claude via @ai-sdk/anthropic and the Vercel AI SDK
  • Automation — Browserbase + Stagehand for browser tasks
  • Email — AgentMail for send / reply / open tracking
  • Jobs — QStash (Upstash) for scheduled signal runs
  • UI — Tailwind CSS 4, shadcn/ui
  • Testing — Vitest, Playwright

🚀 Quick start

You'll need Node 20+, Docker, the Supabase CLI, a Supabase project (hosted or local), and an Anthropic API key.

git clone https://github.com/jay-sahnan/signal.git
cd signal
corepack enable      # activates the pinned pnpm version
pnpm install
pnpm setup           # interactive: prompts for required keys, runs migrations
pnpm dev             # http://localhost:3000

Prefer to configure by hand? Follow docs/setup.md.


🐳 Self-host with Docker

cp .env.example .env
# fill in SUPABASE_URL + ANTHROPIC_API_KEY at minimum
docker compose up -d

Signal does not bundle Supabase in the compose file — bring your own (hosted Supabase project or local supabase start). See docs/setup.md for the full walkthrough.


🤝 Contributing

Issues and PRs welcome. Start with .github/CONTRIBUTING.md. AI-assisted PRs are fine — we build with Claude ourselves.

Looking for somewhere to start? Filter issues by good first issue.


💬 Community

  • 🐛 Issues — bug reports and feature requests
  • 💡 Discussions — questions, ideas, show & tell
  • 🔒 Security — vulnerability disclosure



📄 License

AGPL-3.0 with an optional enterprise carve-out for files explicitly tagged. See the license file for details.

About

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors