EtanHey/golems

Golems is a Bun monorepo with two parts: a set of TypeScript agent packages, and
golem-powers, a library of SKILL.md workflows for AI coding agents. Many
skills ship executable evals.
It is for two kinds of reader. The first builds with AI coding agents (Claude
Code, Codex, Cursor) and wants skills and evals to reuse or copy. The second
wants to see how one developer runs a fleet of coding agents day to day.
This is one person's working setup, published in the open. Many
packages and skills assume the author's machine, accounts, and tools. Read them
as working examples, not as a supported product.
Two terms:
A golem is a package that handles one domain (email, finance, planning).
It holds the code, prompts, and integrations for that domain.
A skill is a SKILL.md file that an agent loads and follows. It can come
with scripts, references, and evals.
## Quick start
Install the nightly skills and CLI wrappers without a Git checkout:
sh
curl -fsSL https://raw.githubusercontent.com/EtanHey/golems/master/scripts/release/install.sh | sh -s -- --channel nightly
The bootstrap uses standard macOS/Linux utilities, curl, tar and shasum; it
verifies the release before switching ~/.golems/current. Skills are linked
for Claude and Codex from the per-client lists in skills/catalog.json.
Add ~/.golems/bin to PATH, then use golems-cli update
to install the newest nightly. Running golems-cli requires Bun; pr-watch requires
Python 3 and GitHub CLI. Existing checkout skill links are kept unless you pass
--replace-checkout-links. Other-repo links and real directories are preserved;
updates remove retired release-owned links. Hook installation is a separate step.
See release installation for pinned and offline installs.
For a former M1 owner install, run the nightly release installer above with
--replace-checkout-links, then run node ~/.golems/current/scripts/hooks/install-hooks.mjs
--host client --source ~/.golems/current --migrate-owner-install --apply and verify
node ~/.golems/current/scripts/hooks/install-hooks.mjs --host client --source
~/.golems/current --status reports drift=0. The migration archives the old owner
pin and hooks-live links under ~/.golems/archive/owner-install- - /
with a receipt, and restores the install if a write fails. The MBP owner refuses
this flag. Native Codex /hooks trust review remains a separate step.
For development from a checkout:
You need Bun, Node.js, and Git. CI
reads its Bun version from .bun-version, so install that version locally too.
One test checks for the claude CLI on your PATH. CI stubs it, and you can
do the same.
bash
git clone https://github.com/EtanHey/golems.git
cd golems && bun install
bun run test
bun run test runs bun test ./packages, the same package suite CI runs. Use
it instead of a bare bun test, which also picks up tests from any local
untracked folders.
## Packages
There are 10 workspace packages under packages/:
| Package | What it is |
| claude | Persona and Claude CLI status plugin |
| coach | Daily scheduling, calendar sync, habit tracking, briefings |
| content | Content pipelines (LinkedIn, ghostwriting) and Remotion video rendering |
| golem-skills | The CLI, published as golems-cli: installs and lists skills, checks setup |