Golems

Spawn→Work→Die→Remember

golems

         ▄▄████████▄▄
       ▄██▓░░░░░░░░▓██▄
     ▄██▓░░┌──────┐░░▓██▄
    ███▓░░░│ אמת  │░░░▓███
   ███▓░░░░└──────┘░░░░▓███
   ███▓░░░░░░░░░░░░░░░░▓███
  ████▓░░■■■░░░░░░■■■░░▓████
  ████▓░░■◆■░░░░░░■◆■░░▓████
  ████▓░░■■■░░░░░░■■■░░▓████
   ███▓░░░░░░░░░░░░░░░░▓███
   ███▓░░░░╔══════╗░░░░▓███
   ███▓░░░░║ {··} ║░░░░▓███
    ███▓░░░╚══════╝░░░▓███
     ▀██▓░░░░░░░░░░░░▓██▀
    ╔══▀████████████████▀══╗
    ║                      ║

$ golems wizard

=== GOLEMS SETUP WIZARD ===

Phase 1: Prerequisites

✓ bun v1.2.4

✓ Claude Code v2.1

✓ 1Password CLI

○ Railway CLI (optional)

Phase 2: Services

[1] Telegram Bot — Chat + notifications

[2] Email Golem — Triage + routing

[3] Job Golem — Board scraping

[4] Night Shift — 4am improvements

Select services to enable [1-4, all]: all

Phase 3: Wiring

✓ Created ~/.golems-zikaron/

✓ Installed LaunchAgents (4 services)

✓ Wired MCP servers (zikaron, email, jobs)

✓ Linked golems CLI to ~/bin

✔ Setup complete! Run golems status to verify.

Get Started Architecture GitHub →

Golems

6 golems online

👤Etan8:12

hey, what did you get done while I was asleep?

🤖ClaudeGolem8:12

Night Shift ran from 3-5am. Shipped 2 PRs on songscript, fixed that flaky test. All green.

👤Etan8:13

nice. any urgent emails?

🤖ClaudeGolem8:13

Stripe payment failed — card expired. Also a 9.2 job match came in and Sarah replied about Thursday. Check Alerts.

See all topics →

Get Started in 60 Seconds

Four commands. That's it.

Clone

git clone https://github.com/EtanHey/golems && cd golems

Get the monorepo

Install

bun install

One command, all packages

Setup

golems wizard

Interactive 3-phase wizard wires everything

Verify

golems status

See all your golems running

Full Setup Guide

Meet the Golems

6 golems + infrastructure. Each golem owns a domain, not an I/O channel.

🤖

ClaudeGolem

Telegram orchestrator. Routes commands to domain golems, spawns Claude sessions, manages notifications.

📧

Email System

Scores, categorizes, and routes incoming email. Infrastructure in @golems/shared.

💼

RecruiterGolem

Contact finder, style-adapted outreach, follow-ups, and 7-mode interview practice with Elo tracking.

💰

TellerGolem

Tax categorization (Schedule C), payment alerts, monthly and annual expense reports.

🎯

JobGolem

Scrapes Indeed, SecretTLV, Drushim, Goozali. LLM-scored matching with auto-outreach for 8+ scores.

📅

CoachGolem

Calendar sync, daily planning, ecosystem status aggregation. Reads all golems, helps you prioritize.

✍️

ContentGolem

LinkedIn drafting, Soltome publishing, ghostwriting. Critique-wave pipeline for quality content.

🌙

Services

Night Shift (4am), Morning Briefing (8am), Cloud Worker (Railway), Wizard, Doctor health checks.

🔄

Ralph

Autonomous coding loop. Reads PRDs, implements stories, reviews with CodeRabbit, commits and PRs.

🧠

Zikaron

Memory layer. 238K+ indexed chunks across all sessions. Semantic search in under 2 seconds.

How It Works

Mac is the brain, Railway is the body

Your Mac (Brain)

Telegram Bot
Night Shift
Zikaron Memory
Notification Server

↔

Railway (Body)

Email Poller
Job Scraper
Briefing Generator

Explore Architecture →