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