How etanhey/golems works
Golems is a personal-use monorepo combining TypeScript domain packages with reusable AI-agent skill workflows. A typical package workflow starts with a CLI, service, or agent-facing request, then uses domain logic and shared integrations to produce a result: coaching briefings, content, email handling, finance reports, or invoice operations. The README documents the package capabilities; sampled source confirms selected call paths in coaching, content, services, and the CLI. The skill library is a separate major product branch. Several package internals are unsampled, so those branches are shown at package level rather than with speculative calls.
Main entry points: http-service.ts Content HTTP API · schedule-engine.ts Coaching & Calendar · briefing.ts Briefing Service · db-client.ts Email Golem
Components 22
Entry Points
- Skills CLI
packages/golem-skills/src/index.ts - Terminal Dashboard
packages/golems-tui/src/components/Dashboard.tsx - Scheduled Services
packages/services/src/cloud-worker.ts
Domain Packages
- Coaching & Calendar
packages/coach/src/schedule-engine.ts - Briefing Service
packages/services/src/briefing.ts - Email Golem
packages/shared/src/email/db-client.ts - Finance & Subscriptions
packages/teller/src/report.ts - Invoice MCP
packages/green-invoice-mcp/src/mcp-server.ts - Mock MCP Server
packages/mock-mcp/src/mock-mcp-server.ts - Claude Plugin
packages/claude
Shared Runtime
- LLM Providers
packages/shared/src/lib/cloud-llm.ts - Supabase & State
packages/shared/src/lib/supabase-factory.ts - Email Routing
packages/shared/src/email/router.ts
Content Production
- Content HTTP API
packages/content/src/http-service.ts - Pipeline Router
packages/content/src/pipeline/router.ts - Image Generation
packages/content/src/comfyui/index.ts - Video Rendering
packages/content/src/render/render-service.ts - Data Visualizations
packages/content/src/dataviz/renderer.ts
Agent Skills
- Skill Workflows
skills/golem-powers - Research Workflow
skills/golem-powers/cursor-workflows/research/research.py - AutoCursor Agent
skills/golem-powers/cursor-workflows/lib/autocursor.py
Other components
- Developer / Agent
Connections 22
- Developer / Agent → Skills CLI: runs commands
- Skills CLI → Skill Workflows: lists / installs
- Developer / Agent → Terminal Dashboard: views status
- Scheduled Services → Briefing Service: loads briefing
packages/services/src/cloud-worker.ts - Briefing Service → Coaching & Calendar: uses coaching
packages/services/src/briefing.ts - Briefing Service → Finance & Subscriptions: uses finance
packages/services/src/briefing.ts - Coaching & Calendar → LLM Providers: requests advice
- Coaching & Calendar → Supabase & State: reads statuses
- Coaching & Calendar → Email Golem: syncs calendar
- Email Golem → Email Routing: routes messages
packages/shared/src/email/db-client.ts - Email Golem → Supabase & State: persists data
packages/shared/src/email/db-client.ts - Finance & Subscriptions → Supabase & State: stores reports
- Invoice MCP → Developer / Agent: serves MCP tools
- Developer / Agent → Content HTTP API: requests content
packages/content/src/http-service.ts - Content HTTP API → Pipeline Router: executes plans
packages/content/src/http-service.ts - Content HTTP API → Image Generation: generates images
packages/content/src/http-service.ts - Content HTTP API → Video Rendering: renders video
packages/content/src/http-service.ts - Content HTTP API → Data Visualizations: renders charts
packages/content/src/http-service.ts - Research Workflow → AutoCursor Agent: invokes agent
skills/golem-powers/cursor-workflows/research/research.py - Developer / Agent → Skill Workflows: loads workflows
- Developer / Agent → Mock MCP Server: tests skill behavior
- Developer / Agent → Claude Plugin: uses persona plugin